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Actividades Sugar 

1. Introduccion 

2. iQue es Sugar? 

3. iQue es una Actividad Sugar? 

4. iQue tengo que saber para hacer una Actividad Sugar? 



J. • Introduccion 



"Este libro constituye el relate de un viaje de placer. Si se tratase de 
registrar una solemne expedicion cientifica, rezumaria esa gravedad, 
esa profundidad y esa impresionante incomprensibilidad que tan 
apropiadas resultan en las obras de ese tipo y que, al mismo tiempo, son 
tan atractivas." - Mark Twain. Prefacio de la novela "Guia para viajeros 
inocentes." 

Este libro se propone ensenarte todo lo que necesitas para escribir tus 
propias Actividades para Sugar; entorno operativo desarrollado para el 
proyecto OLPC (una laptop por nino). No se requiere saber programar 
para leer este libro, sin embargo los programadores tambien 
encontraran aca informacion util. Animar a los no-programadores, 
incluyendo a los ninos y a sus maestros a escribir sus propias Actividades 
para Sugar, es mi objetivo principal. Para eso, voy a incluir algunos 
detalles que otros libros omitirian y a la vez dejar afuera temas que 
otros libros incluirian. La "impresionante incomprensibilidad" sera 
reducida al minimo. 

Si solo quieres aprender a escribir programas para computadoras en 
general. Sugar trae varias Actividades que te ayudaran a lograrlo como 
Etoys, Turtle Art, Scratch o Pippy. Sin embargo, ninguna de estas es 
adecuada para la creacion de Actividades, asi que no las estudiaremos 
en este libro aunque sean excelentes formas de aprender a programar. 
Si tu decision de tratar de escribir tu propia Actividad viene de haber 
jugado con estas herramientas, veras que estas te dejaron una buena 
base de conocimiento para entender el tema. 

Si programaste antes, ya conoces la satisfaccion de poder usar 
programas hechos por vos mismo que hacen exactamente lo que tu 
quieres que hagan. Crear una Actividad Sugar tiene otras satisfacciones 
adicionales, una Actividad util puede ser traducida a una diversidad de 
idiomas, puede ser descargada centenares de veces por semana y puede 
ser usada por incontables estudiantes a lo ancho del mundo. 
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Un libro que pretendiera ensenar todo lo importante para escribir 
Actividades seria realmente muy largo y ademas redundante porque 
duplicaria los materiales que ya estan disponibles por ahi. Por lo tanto, 
voy a tratar de escribir una especie de visita guiada sobre el Desarrollo 
de Actividades. Me refiero por ejempio a que voy a ensenarte que es 
Python y por que es importante, pero no voy a ensenarte el lenguaje en 
SI mismo. Hay excelentes tutoriales en la red para esto y voy a ir 
agregando las referencias necesarias para que puedas usarlos. 

Hay bastantes ejemplos de codigo en el libro, pero no hay necesidad de 
que los copies "a mano" para probarlos. Todo el codigo esta en un 
repositorio Git que puedes directamente descargar en tu computadora. 
Si nunca usaste Git, hay un capitulo que te explica que es y como debes 
usarlo. 

Apenas recibi mi laptop XO empece a escribir Actividades. Al principio, no 
tenia nada del material que resumo en el libro y tuve que pasar algunos 
momentos duros hasta saber como manejarme. A mi favor tenia mis 
casi 30 ahos de experiencia como programador profesional que hacen 
que realmente piense como un programador. Esto implica, enfrentar 
una tarea compleja y saber dividirla en partes manejables. Saber como 
deberian funcionar algunas cosas y en base a esto deducir como 
funcionan de hecho. Tambien saber donde y como buscar informacion o 
pedir ayuda, y por ultimo lograr un punto de arranque del trabajo que, 
aunque no sea el ideal, sirva para alcanzar la meta. 



Por haber atravesado ya estas etapas, creo que puedo ser un buen gufa 
para la tarea de escribir Actividades Sugar y ademas, sobre el camino, 
espero tambien ensenarte a pensar como piensa un programador. 

Es posible que de tiempo en tiempo agregue capitulos a este libro. 
Sugar es una gran plataforma para aplicaciones y este libro solo puede 
aspirar a contarte lo que es posible hacer. Mi esperanza es que, en 
futuras versiones del libro, se incluyan capitulos invitados que versen 
sobre topicos avanzados y que esten escritos por otros experientes 
desarrolladores de Actividades. 

Formatos disponibles del libro 

Este libro es parte del proyecto FLOSS Manuals y esta entonces 
disponible para leerse desde el sitio web: 

http://es.flossmanuals.net/ El original en ingles esta en 
http//en.flossm a nuals.net/ 

Tambien puedes comprar una copia impresa y encuadernada del libro en 
ingles en Lulu.com: 

http://stores.lulu.com/flossmanuals 

En Internet Archive tambien esta disponible una copia del libro ingles 
original como PDF a todo color asi como versiones descargables 
gratuitamente en EPUB, MOBI, y DjVu. 

http://www.archive.org/details/MakeYourOwnSugarActivities 

La tienda Amazon Kindle Store tiene exactamente la misma version 
MOBI que esta en Internet Archive. 

Si prefieres leer este libro sobre un Kindle, te advierto que la pantalla 
angosta del Kindle no se adecua a mostrar correctamente los programas 
listados. Sugiero que te refieras al sitio de FLOSS Manuals para ver el 
codigo debidamente formateado. - 



1. Extracto de la edicion espahola de "Guia para viajeros inocentes" 
cedido a este manual por la coleccion chilena Viento Simun 
ISBN9788496964440. Traduccion Susana Carral Martinez- 

2. Traducido Ana Cichero— 



Za • ^Que es Sugar? 



Sugar es la interfaz de usuario disenada para la laptop XO. Se puede 
instalar en la mayoria de las PCs, incluyendo modelos antiguos que no 
pueden correr las versiones recientes de Windows. Tambien se puede 
instalar en un dispositivo flash (Sugar on a Stick) y bootear la 
computadora desde ahi. 

Cuando la laptop o computadora portatil XO salio a la luz, algunas 
personas cuestionaron la necesidad de una nueva interfaz de usuario. 
iNo seria mejor para los ninos aprender algo util y parecido a lo que 
utilizaran al ser adultos? iPor que no darles Microsoft Windows en lugar 
de otra interfaz? 

Esta seria una pregunta razonable si la unica meta fuera entrenar a los 
ninos a usar computadoras. Seria todavia mas razonable si pudieramos 
estar seguros de que el software que utilizaran de adultos lucira y 
funcionara como los Microsoft Windows de hoy. Pero estas suposiciones 
no son nada razonables. 

El proyecto OLPC no se trata solo de alfabetizacion digital. Se trata de 
ensenanza de lectura, escritura, aritmetica, historia, ciencias, artes, 
programacion de computadoras, composicion de musica y mucho mas. 
No se espera que los ninos utilicen las computadoras solamente para 
sus trabajos escolares, sino tambien que las utilicen en sus casas para 
investigar temas de su interes personal. 

Esto es mas ambicioso que simplemente disponer de computadoras en 
educacion. Por eso era razonable replantearse el modo en que los ninos 
deben trabajar con las computadoras. Sugar es el resultado de ese 
replanteo. 

Sugar tiene las siguientes caracteristicas unicas: 



Diario (journal) 



El Diario o Journal es donde se pueden ver todos los trabajos. En vez de 
archivos y carpetas contiene una lista de entradas organizadas en orden 
decreciente por fecha y hora de ultima modificacion. Es similar a los 
"Documentos recientes" de Windows, excepto que en lugar de contener 
solamente las ultimas entradas, las contiene a todas. El Diario es una 
manera natural de guardar y retomar los trabajos en Sugar. 

El Diario hace facil organizar el trabajo. Guarda cualquier trabajo que se 
haga y guarda cualquier descarga hecha desde la web. Si alguna vez 
descargaste un archivo usando un browser y se guardo en un directorio 
distinto del habitual y perdiste un buen tiempo buscandolo o si ayudaste 
a tus padres en una situacion similar, comprenderas inmediatamente la 
utilidad de El Diario. 

El Diario almacena metadatos para cada entrada contenida en el. Los 
metadatos son datos sobre los datos. Cada entrada de diario tiene un 
titulo, una descripcion, una lista de palabras claves (tags o etiquetas) y 
una captura de pantalla del ultimo acceso a esa entrada. 
Cada entrada tiene un codigo identificador (activity id) que refiere a la 
Actividad que la crea, tambien puede contener el tipo MIME (esto 
permite que entradas del Diario no creadas por ninguna Actividad 
puedan ser abiertas por una Actividad que soporte el tipo MIME 
declarado). 

Ademas de la metadata generica descrita en el parrafo anterior, una 
entrada del Diario puede contener metadata propia de la Actividad que 
los creo. Por ejempio, la Actividad Read (Leer) utiliza metadata 
especifica donde guarda la pagina que leias antes de cerrar la Actividad. 
La Actividad retomara esa misma pagina cuando vuelvas a abrirla. 

Ademas de trabajos creados por Actividades, el Diario puede contener 
directamente Actividades. Si al visitar http://activities.sugarlabs.org con 
la Actividad Browser, se descarga una Actividad, esta quedara 
automaticamente guardada en el Diario y lista para usarse. Si ya no se 
quiere utilizar la Actividad es suficiente suprimiria en el Diario para que 
se elimine totalmente. No existen programas de desinstalacion, ni cajas 
de dialogo que pregunten sobre eliminar tal o cual DLL. No quedan cabos 
sueltos ni ningun resto de una Actividad desinstalada. 



Colaboracion 

La Colaboracion es la segunda caracteristica unica de Sugar. 
Colaboracion implica que las Actividades pueden ser usadas por mas de 
una persona a la vez. Aunque no toda Actividad necesita esa 
caracteristica y hay Actividades que no la aprovechan, toda Actividad de 
primera linea seguro incluye alguna forma de interaccion en red con 
otros usuarios Sugar. Por ejempio, los lectores de e-books pueden darle 
una copia del libro que estan leyendo (con todas las notas que hayan 
agregado) a un amigo, o a la clase entera. La Actividad Write (Escribir) 
permite que varios estudiantes trabajen en el mismo documento de 
forma conjunta y Distance (Distancia) permite que dos estudiantes 
averiguen que tan lejos/cerca estan uno de otro. 

Hay distintas vistas del sistema y se seleccionan pulsando un boton 
(Teclas de Funcion Fl-4) 

• La vista Vecindario 

• La vista Amigos 

• El anillo de Actividades 

• El Journal 

Las dos primeras son para aprovechar la Colaboracion. 

La vista Vecindario muestra un icono por cada persona en la red. Cada 
icono se ve como una figura estatica que superpone una "0" sobre una 
"X". Cada icono tiene un nombre que el estudiante elige al configurar su 
maquina. Cada icono se despliega en dos colores que tambien elige el 
estudiante. Ademas de los iconos de "XO", habran iconos representando 
redes malla (mesh) e iconos representando puntos de WiFi. Finalmente 
habran iconos representando Actividades cuyos duehos optaron por 
compartir. 

Consideremos la Actividad Chat para entender como funciona. La forma 
usual para hacer un chat, requiere que todos los participantes 
arranquen un cliente de chat y visiten un mismo chat room en un 
mismo momento. En Sugar es distinto. Un estudiante inicia la Actividad 
Chat en su propia computadora e invita a otros de la red a participar; 
estos veran un icono de Chat en su Vecindario y podran aceptar. El acto 
de aceptar inicia la propia Actividad Chat y los conecta con los otros 
participantes. 



La vista Amigos es similar a la vista Vecindario pero solo contiene a las 
personas que esten etiquetadas como Amigos. La colaboracion puede 
darse en tres niveles: directo con personas, con todo el vecindario o con 
todos los amigos. No es necesario solicitar la amistad, alcanza con darla. 
Es mas como crear una lista de destinatarios para un mail. 



Seguridad 



Proteger las computadoras de usuarios maliciosos es siempre 
importante y cuando se trata de maquinas de estudiantes es mas 
importante aun. Tambien es mas dificil, porque es impensable que los 
mas jovenes recuerden contrasenas y las mantengan en secreto. Como 
Sugar corre sobre Linux los llamados virus no son un problema pero las 
Actividades maliciosas si lo son. Una Actividad autorizada a tener acceso 
entero al Diario podria borrarlo completamente y alguien podria escribir 
una Actividad entretenida y de apariencia inofensiva que despues de ser 
iniciada una cantidad aleatoria de veces, borre el trabajo del estudiante. 

Una forma usual de prevenir que un programa haga cosas maliciosas es 
obligar a la ejecucion en modo sandbox. Sandbox (arenero en ingles) es 
una forma de limitar las atribuciones de los programas. Con el tipo 
habitual de arenero se tienen programas no-confiables, que 
practicamente no pueden hacer nada, o programas confiables que no 
tienen restriccion alguna. Una aplicacion se transforma en confiable 
cuando es validada por un tercero con una firma. La firma es una 
operacion matematica que se mantiene valida solo mientras no haya 
cambios en el programa. 

Sugar usa un tipo de arenero un poco mas sofisticado para sus 
Actividades. Ninguna Actividad Sugar necesita el sello de confiable y toda 
Actividad interactua con el Journal de manera limitada y por vias 
indirectas. Cada Actividad tiene un directorio especifico con permiso 
para escribir y tiene acceso de solo lectura sobre el resto archivos y 
carpetas. De este modo las Actividades no pueden interferirse entre si. 
A pesar de esto las Actividades pueden resolver todo lo que necesiten 
hacer. 

Resumen 

Sugar es un entorno operativo disenado para respaldar la educacion de 
los ninos. Organiza el trabajo del nino sin requerir archivos ni carpetas. 
Soporta la colaboracion entre estudiantes y ademas provee de un 
modelo de seguridad robusto que previene que programas maliciosos 
dahen el trabajo de un estudiante. 

No seria una sorpresa si algun otro entorno de escritorio empezara a 
adoptar alguna de estas caracteristicas. 
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1. Traducido Ana Cichero Uruguay- 



O • iQue es una Actividad Sugar? 

Una Actividad Sugar es una aplicacion independiente Sugar 
empaquetada en un bundle .XO. 

Un bundle (paquete) .XO es una carpeta de archives en fornnato Zip. 
Conteniendo: 

• Un archive llamado MANIFEST (manifiesto) que lista todo lo del 
bundle. 

• Un archive activity.info que contiene los atributos que describen la 
Actividad, parejas como nombre=valor. Los atributos incluyen 
ademas del nombre, el numero de version, un identificador y otras 
cosas que discutiremos en el momento de crear la Actividad. 

• Un archivo de icono ( en formato SVG) 

• Archives que contienen todas las cadenas de texto que tu Actividad 
use traducidas en distintos idiomas. 

• El codigo del programa de tu Actividad. 

Una Actividad Sugar siempre incluye un codigo en Python que extiende 
una clase de Sugar llamada Activity. Tambien puede incluir tramos de 
codigo escritos en otros lenguajes de programacion, siempre y cuando 
Python pueda ligarlos entre si. Estos se conocen como Python bindings 
(ligaduras de Python). Incluso es posible escribir una Actividad Sugar sin 
utilizar Python en lo mas minimo, pero esto esta fuera de nuestro 
alcance en este libro. 

Son muy pocas las cosas que una Actividad pueda depender que este 
incluida en cada version de Sugar. Estas incluyen modulos como 
Evidence (PDF y otros visualizadores de documentos). Gecko 
(rendereado de paginas web) y las librerias PyGame y PyGTK de Python. 
Todo lo que la Actividad necesite para ejecutarse y no este provisto por 
Sugar debera ser empaquetado en un archivo bundle. Una pregunta 
frecuente en los correos es como hacer para que Sugar instale X al 
ejecutar mi Actividad. La respuesta es no hay forma, si necesitas X 
debes incluirlo en tu bundle. 1 

Se puede instalar una Actividad copiandola o descargandola al Journal 
(Diario). Se desinstala simplemente borrandola. No hay que crear 
instaladores, no hay que decidir donde instalar los archivos, no hay 
riesgos de que al instalar una Actividad interfiera o rompa otra 
instalada. 
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Una Actividad generalmente crea y lee objetos en el Journal (Diario). 
Una Actividad de primera linea, seguramente tambien provea metodos 
para ser compartida simultaneamente por varios usuarios. 



1. NT En el caso de Java, la Actividad puede recurrir a instalar Java.xo 
conno bundle de modo que esta instalacion no se multiplique en cada 
actividad que use java.^— 

2. NT: Traducido Ana Cichero^— 
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4 • ^Que tengo que saber para hacer una 
Actividad Sugar? 

Para escribir una Actividad Sugar debes saber algo de los temas que 
menciono en este capitulo. 

No hay que ser experto en ninguno de los temas, pero es necesario 
mantener como referencias marcadores las paginas web de cada uno y 
darle una ojeada a los tutoriales mencionados. Esto te ayudara, tambien, 
a entender los ejemplos de codigo que iremos viendo. 

Python 

Python es el lenguaje mas usado para escribir Actividades. Aunque se 
usen otros lenguajes, la mayoria de las Actividades usan algo de Python 
en ellas. Sugar incluye una API (Interfaz de Programacion de 
Aplicaciones) para Python que simplifica la creacion de las Actividades. 
Es bastante inusual, aunque posible, desarrollar una Actividad sin 
utilizar nada de Python (como en Etoys). 

Todos los ejemplos de este libro estan integralmente escritos en Python. 

Existen lenguajes compilados y lenguajes interpretados. En el lenguaje 
compilado el codigo que uno escribe es traducido a lenguaje de maquina 
y esta traduccion es la que realmente se ejecuta en el sistema operativo. 
En un lenguaje interpretado interviene otro programa, llamado 
interprete, que va leyendo el codigo que se escribio y haciendo lo ahi 
indicado (esto esta demasiado simplificado pero suficientemente 
aproximado a la verdad para este capitulo). 

Python es un lenguaje interpretado. Todos los lenguajes, interpretados o 
compilados, tienen ventajas especificas. Las ventajas de Python para el 
desarrollo de Actividades son: 
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• Es portable. En otras palabras, permite que tu programa corra en 
distintos procesadores y distintos sistemas operatives sin tener que 
hacer una version para cada uno. El programa compilado funciona 
segun el sistema y el procesador para el cual se haya compilado. 

• Como el ejecutable es el propio codigo fuente, no es posible darle a 
alguien un programa en Python sin darle el codigo fuente. Hay 
entonces mucho material para estudiar y se puede aprender 
muchisimo sobre programar Actividades estudiando codigo escrito 
por otros. 

• Es un lenguaje facil de aprender para un programador principiante 
pero a la vez tiene las caracteristicas que un experto necesita. 

• Su uso esta muy difundido. Google es uno de los usuarios mas 
famosos de Python. Tanto lo usan, que lanzaron un proyecto llamado 
"Unladen Swallow" para que los programas en Python corran mas 
rapido. 

La gran ventaja del lenguaje compilado es que puede correr mucho mas 
rapido que el interpretado. Pero, en la practica un programa Python 
puede tener una performance igual de buena que un programa escrito 
en lenguaje compilado. Para entender esto, hay que entender como esta 
hecho un programa en Python. 

Se conoce a Python como un lenguaje "glue" (pegamento en ingles). La 
idea es poder tener modulos escritos en otros lenguajes (generalmente 
C y C+ + ) y "envolverlos" en Python. Python se usa para pegar (glue) 
estos modulos y asi crear aplicaciones. En la mayoria de las aplicaciones, 
la mayor parte de las funciones del programa se hacen a traves de estos 
modulos compilados. Es poco, entonces, el tiempo que la aplicacion 
gasta en correr el codigo Python que es el que Integra estos modulos en 
una sola unidad. 

Ademas, no solo las Actividades usan Python, la mayor parte del entorno 
Sugar esta escrito en Python. 

Si ya programaste en otros lenguajes, hay un buen tutorial para 
aprender Python en el propio sitio: http://docs.python.org/tutorial . - 

Si estas recien empezando a escribir programas, tal vez sea mejor mirar 
Invent Your Own Computer Games With Python, que puede leerse gratis 
en http://inventwithpython.com/ . 

PyGTK 

GTK+ ( Gimp Tool Kit +) es un set de modulos para crear interfaces de 
usuario. Estos modulos incluyen botones, barras de desplazamiento, 
listas desplegables, etc. Es el utilizado por el escritorio de GNOME y por 
las aplicaciones que alli funcionan. Las actividades de Sugar usan un 
tema de GNOME que les da a estos controles hechos en GTK+ un aspecto 
unico. 
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PyGTK es el set de librerias de Python que te permiten usar los modulos 
de GTK+ en programas Python. Para ver como se usa, hay un tutorial en 
el sitio de PyGTK: http://www.pygtk.org/tutorial.htnnl . 

PyGame 

La alternativa al uso de PyGTK en tu Actividad es usar PyGame (game es 
juego en ingles). PyGame puede crear el tipo de imagenes llamada 
"sprite" y moverlas alrededor de la pantalla ( "sprites" refiere a los 
duendes que hacian de personajes en videojuegos) . Como podia 
esperarse Pygame se usa principalmente para escribir juegos. Su uso en 
Actividades es menos frecuente que el de PyGTK. 

El tutorial para aprender PyGame esta en el sitio de PyGame: 
http://www.pygame.org/wiki/tutorials . En el sitio hay tambien un lote de 
proyectos que se pueden descargar y probar. 



1. NT: Recursos en espahol acerca de python, pygame, pygtk (2011) 
https://sites.google.com/site/sugaractivities/ 
http://iie.fing.edu.uy/cursos/course/view.php7id = 173 
https://sites.google.com/site/flaviodanesse/programacion-p 
h ttp ://cei baljam.org/dru pa l/?q=docum en tacion 
gstreamer: http://codigosdeejemplo.blogspot.com/ 



2. Traducido Ana Cichero Uruguay- 
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Programacion 

5. Instalar el entorno de desarrollo. 

6. Crear tu primer Actividad Sugar 

7. Un programa Python autonomo para leer Etexts 

8. Heredar una Actividad desde sugar. activity.Activity 

9. Empaquetar tu Actividad 

10. Agregar detalles 

11. Anadir tus fuentes al control de versiones 

12. Internacionalizarse con Pootle 

13. Distribuir tu Actividad 

14. Depurar Actividades Sugar 
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D • Instalar el entorno de desarroUo. 



Aunque desarrollar actividades para la XO en la propia XO no es la 
opcion mas practica, no deja de ser posible. Es mas facil y aumenta la 
productividad de tu desarrollo, escribirlo y testearlo en una maquina que 
use un OS (sistema operativo) convencional. Esto te dara acceso a 
mejores herramientas y podras, incluso, simular la colaboracion entre 
dos computadoras-Sugar usando solo tu maquina. 

^Instalar Linux o usar una maquina virtual? 

Aunque Sugar corre sobre Linux, es posible correr una instancia 
completa de Sugar sobre una maquina virtual con Windows. 

Una maquina virtual es una forma de utilizar un sistema operativo 
encima de otro. El sistema operativo virtual es enganado y cree ser el 
unico que controla la computadora. Los gurus de la industria de la 
computacion dicen que esto lo mas nuevo que hay, pero los viejos como 
yo sabemos que IBM ya lo utilizaba en sus computadoras centrales en los 
anos 70. 

Esta forma de proceder fue, durante algun tiempo, la mas 
recomendable. La version de Linux que Sugar usa era lo suficientemente 
distinta de los Linux regulares que incluso los usuarios Linux corrian 
Sugar con una maquina virtual arriba de su Linux habitual. 

La situacion mejoro y ahora la mayoria de las distribuciones corrientes 
de Linux incluyen un entorno Sugar usable. 

Si estas muy acostumbrado a Windows, podrias pensar que en vez de 
instalarte Linux, la opcion mas sencilla seria correr Sugar sobre una VM 
(Maquina Virtual). Pero en la practica no lo es. Linux sobre una VM es 
Linux igual y tendras que aprender algunas cosas sobre Linux si piensas 
en el desarrollo de Actividades Sugar. Ademas, correr un segundo OS en 
una VM requiere una maquina poderosa y unos cuantos gigabytes de 
memoria. Personalmente, hago mis desarrollos Sugar usando Linux 
sobre una IBM NetVista Pentium IV que me compre por poquito mas que 
cien dolares -embarque incluido- y me resulta mas que adecuada. 

Instalar Linux no es ahora la prueba de fuego que alguna vez fue. 
Cualquiera puede lograrlo. El escritorio GNOME que Linux provee es tan 
similar a Windows que el usuario no siente la diferencia. 
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Tambien esta la opcion de instalar Linux y agregarle un booteo dual para 
poder correr Linux y Windows en la misma computadora (no al mismo 
tiempo). Para esto se precisa dejar una particion del disco para el uso del 
Linux y luego elegir, sobre un menu que se vera al arranque de la 
computadora, cual OS (sistema operativo) lanzar. Los mismos 
instaladores de Linux sirven para crear la particion y un par de gigabytes 
de espacio en disco es mas que suficiente. La instalacion de Linux 
comparte la computadora sin afectar en lo absoluto a la instalacion 
Windows. 

Sugar Labs ha trabajado para tener a Sugar incluido en todas las 
distribuciones de Linux. Si ya tenes una distro favorita, hay buenas 
chances de que en su ultima version ya traiga Sugar incluido. Fedora, 
openSuse, Debian y Ubuntu incluyen Sugar. Si ya tenes un Linux 
instalado averigua si no tiene Sugar ya incluido. Si no. Fedora es el que 
usa la laptop XO, de modo que Fedora 10 o posterior seria la mejor 
opcion. Se puede descargar un CD o DVD de instalacion de Fedora desde: 
https://fedoraproject.org/get-fedora . 

Es importante aclarar que todas las otras herramientas que recomiendo 
vienen incluidas en cualquier distribucion de Linux y se instalan sin 
mayor esfuerzo que el de tildar unas casillas (check boxes en ingles). 
Estas mismas herramientas podrian funcionar en Windows pero 
instalarlas va a implicar mucho mas trabajo que el habitual para 
programas Windows. 

Si no deseas instalar y aprender nada de Linux, pero igual quieres 
desarrollar Actividades, te queda la opcion de desarrollar un programa 
Python independiente que use PyGame o PyGTK y que haga lo que tu 
Actividad haria. Puedes darle tu programa a otra persona para que lo 
convierta en una Actividad Sugar. Este programa Python puede 
escribirse en Windows o en una Macintosh. 

Si quieres desarrollar en una Macintosh, la opcion mas elegante es 
correr Sugar en una maquina virtual. Si te interesa hacer la prueba hay 
mas detalles en este link: http://wiki.laptop.org/go/Developers/Setup. 
Tambien es posible instalar usando un booteo dual con Linux Fedora 
sobre una Intel o Power PC Macintosh. Hay detalles de esto en el sitio 
web de Fedora. 

Otra opcion para los usuarios de Mac es utilizar como entorno de testeo 
a Sugar on a Stick. Para informarte acerca de esto: 
http://wiki.sugarlabs.org/go/Sugar_on_a_Stick . 
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^Que tal usar sugar-jhbuild? 

Sugar-jhbuild es un script que descarga el codigo fuente de las ultimas 
versiones de los modulos de Sugar y los compila en un subdirectorio de 
tu directorio Home (hogar en ingles). No instala Sugar en tu sistema. Lo 
que hace es correr Sugar desde el directorio donde se compilo. Por la 
forma en la que viene construido y como se ejecuta, no interfiere con los 
modulos que levantan el escritorio que normalmente utilizas. Si vas a 
desarrollar para Sugar mismo o para Actividades que requieran las 
caracteristicas mas recientes de Sugar, vas a necesitar sugar-jhbuild. 

Correr este script es un poquito mas dificil que instalar los paquetes de 
Sugar que vienen con tu distribucion de Linux. Vas a necesitar primero 
instalar Git y Subversion, luego ejecutar un comando Git desde terminal 
y descargar el script sugar-jhbuild, en tercer lugar correr el script -que 
te presenta varias opciones para descargar e instalar paquetes distintos- 
y por ultimo compilar todo. Puede tomarte un par de horas completar 
todos los pasos. Al terminar tendras un entorno actualizado de testeo 
que puede funcionar como un emulador de Sugar. No hay necesidad de 
desinstalar el emulador, si existiera uno, emulador y jhbuild pueden 
coexistir. 

Debes ejecutarlo con estos comandos: 

cd sugar-jhbuild 

./sugar-jhbuild run sugar-emulator 

IMe conviene usarlo? La respuesta corta es no. Una respuesta mas larga 
probablemente sea todavfa no. 

Si deseas que tus Actividades alcancen el mayor numero de usuarios no 
te conviene usar el Sugar mas reciente. De hecho, si quieres un entorno 
de testeo que imite lo que la mayoria de las XO usan ahora, te conviene 
usar Fedora 10. Esto sucede porque, para las escuelas, es una dificil 
tarea actualizar los sistemas operativos de las XO y la mayoria de ellas 
quedaran corriendo Sugar. 82, o incluso anterior, por bastante tiempo. 

Por supuesto tambien es importante tener desarrolladores dispuestos a 
ampliar las fronteras de lo que Sugar puede hacer. Si despues de 
desarrollar algunas Actividades, concluyes que tu eres uno de ese grupo, 
puedes aprender sobre sugar-jhbuild en este link:: 
http://wiki.sugarlabs.org/go/DevelopmentTeam/Jhbuild. 

Estrictamente hablando, sugar-jhbuild es tan solo un script que descarga 
y compila Sugar. De forma correcta deberiamos decir: "Ejecuto la copia 
del emulador de Sugar que se construyo con sugar-jhbuild", pero la 
mayoria de los desarrolladores Sugar dicen: "Ejecuto sugar -jhbuild" y 
esta es la expresion que usare en este libro. 
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python 



Todos los ejemplos de codigo los haremos en Python, asi que debes 
tener Python instalado. Python viene con todas las distribuciones de 
Linux pero tambien se pueden descargar los instaladores para Windows 
Macintosh en http://www.python.org/ . 

Eric 

Los desarrolladores esperan que los lenguajes que usan sean soportados 
por un IDE (Entorno de Desarrollo Integrado, Integrated 
Development Enviroment en ingles). Python no es una excepcion. Un 
IDE te ayuda a organizar el trabajo y ademas incorpora un editor de 
texto y un set de herramientas de programacion y de debugging 
(depuracion). 

Hay dos IDE para Python que personalmente probe: Idle y Eric. Eric, es el 
mas recomendable de los dos. Todas las distros de Linux deberian 
incluirlo. Parece que tambien funciona sobre Windows. Puedes 
informarte mejor en el sitio de Eric: http://eric-ide.python-projects.org/ . 
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SPE (Stani's Python Editor) 

Esta es un IDE que descubri mientras escribia este libro. Viene con 
Fedora y ademas de ser un editor Python hace diagramas UML para tu 
codigo y los muestra en PyDoc. Este es SPE mostrando un diagrama 
UML para una de las Actividades comentadas en este libro: 

Si SOS un desarrollador muy experimentado puedes encontrar en SPE 
una alternativa util, en cambio si estas comenzando, Eric sera 
seguramente suficiente. 
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Otros IDE's 

Hay tambien un IDE comercial de Python llamado Wingware, el cual 
tiene una version que puedes usar sin costo. Puedes aprender mas 
sobre el en http://www.wingware.com/ . 

Inkscape 

Inkscape es una herramienta para crear imagnes en formato SVG. Sugar 
usa SVG para los iconos de las Actividades y otros graficos. El icono "XO" 
que caracteriza a cada niho en la vista vecindario es un SVG que puede 
ser modificado. 

Inkscape se utiliza para crear el icono de la Actividad. 
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Inkscape viene con toda distribucion de Linux y puede instalarse 
tambien en Windows. Mas informacion en este sitio: 
http://www.inl<sca pe.org/ . 
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Git 

Git es un controlador de versiones. Git guarda una version del codigo de 
tu programa de forma que te sea facil recuperarla. Cada vez que hagas 
un cambio debes pedirle a Git que guarde tu codigo en su repositorio. Si 
precisas recurrir a una version anterior estara disponible. Mejor todavia, 
si surge un problema en tu codigo, Git lo compara con cualquier version 
anterior y te muestra exactamente las lineas que cambiaste. 
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readtoolbar.py 



15 15 # along with this programj if not, write to the Free Software 

l6j 1S;# FoLndation, Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 

17 j 17 I 

IB import OS 

IB 19 import logging 

19 j 20 from gettext import gettext as 

20 1 21 import re 
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pitchbar. showO 

self.ratead] = gtk. Adjustment (0, -100, lOO, 1, 10, 0) 

self. rateadj .connect("value_changed", self. rate_adjusted_cb) J 

ratebar = gtk.HScale(self. rateadj J 

ratebar.set_draw_value(False) 

ratebar. 5et_update_policjf(gtk.UPDA"re_DISCONT[NUOU5) 



def pitch_ad]usted_cb(self , get); 
speech. pitch = int (get. value) 
speech. say [_[" pitch adjusted")) 
f = opentos.path. join [self .activity. get_activlty_root[), 
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Si hubieran dos personas trabajando sobre el mismo programa de forma 
independiente, un sistema de control de versiones combinaria sus 
cambios de forma automatica. 

Imagina que alguien te reporta un bug vergonzoso mientras estas 
trabajando en una version nueva y mas poderosa de una Actividad que 
recien lanzaste. Si usaste Git, no precisas pedirle a las personas que 
esperen hasta el lanzamiento de tu nueva version, alcanza con crear 
una bifurcacion de la version anterior y trabajaria en paralelo con la 
version que estas mejorando. De hecho Git, tratara a la version vieja que 
estas arreglando y a la nueva como dos proyectos separados. 

Puedes aprender mas de Git en su sitio web: http://git-scm .com/ . 

Cuando estes pronto para usar un repositorio Git en tu proyecto puedes 
crear uno aca: http://git.sugarlabs.org/ . Volvere al tema de como crear y 
como usar el repositorio un poco mas adelante en este libro. 

Hay un repositorio Git conteniendo todos los ejemplos de codigo de este 
libro. Despues de que tengas Git instalado puedes copiar este repositorio 
a tu computadora con este comando: 

git clone git : //git . sugarlabs . org/\ 

myo- sugar -activities -examples/main line .git 
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Este comando deber ser tipeado en una unica linea. La retrobarra (\) al 
final de la primera linea se usa en Linux para continuar un comando 
largo en otro renglon. Esta usada aca para lograr que el comando entre 
en el ancho de pagina en la version impresa de este libro. Cuando 
escribas el comando puedes dejaria de lado y escribir myo-sugar- 
activities-examples/mainline.git inmediatamente despues de 
git.sugarlabs.org/. 

Esta convencion para partir comandos largos en multiples lineas sera 
usada muchas veces a lo largo del libro. Vas a ver que el codigo del Git 
generalmente tiene lineas mas largas que el de los ejemplos del libro. 
Por esta razon te recomiendo no tratar de copiar el codigo de estos 
ejemplos y usar en cambio el codigo que descargaste del repositorio Git. 

GIMP 

Gimp es uno de los programas mas utiles y peor nombrados de la 
historia - . Se puede decir que es una version abierta y libre del Adobe 
Photoshop. Para manipular imagenes distintas a las SVG necesitaras 
este programa. 

Se puede usar GIMP para editar las capturas de pantalla. 

Nunca vas a necesitar este programa para el desarrollo mismo de una 
Actividad, pero si sera util a la hora de organizar las capturas de pantalla 
que muestren tu Actividad en accion y de distribuirla. Nada vende tanto 
una Actividad a los usuarios potenciales como las buenas capturas de 
pantalla. 
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Emulacion de Sugar 



La mayoria de las distros Linux vienen con Sugar incluido. Incluso en 
Fedora se puede correr Sugar como una alternativa al entorno de 
escritorio. Al loggearte en el GDM, te aparece Sugar como una opcion de 
escritorio junto con GNOME, KDE, Window Maker y otros manejadores de 
ventanas que hayas instalado. 

Este no es el procedim lento estandar para testear Sugar. Lo normal es 
usar una herramlenta llamada Xephyr y correr el entorno Sugar como 
una ventana en tu equipo. Xephyr corre una sesion-X dentro de una 
ventana y ahi adentro se ejecuta Sugar. De esta manera es sencillo 
obtener capturas de pantalla de Sugar, detener o reiniciar las sesiones 
de Sugar sin tener que reiniciar la maquina, tambien es sencillo correr 
varias copias simultaneas de Sugar para testear colaboracion. 
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Volveremos a esto cuando sea el momento de probar tu primer 
Actividad. 



1. NT: GIMP es acronimo para GNU Image Manipulation Program- 

2. Traducido Ana Cichero Uruguay— 
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0« Crear tu primer Actividad Sugar 

Haz primero un programa autonomo en Python 

El mejor consejo para el que se inicia en el desarrollo de Actividades es 
hacer una version de la misma que funcione por su cuenta, 
independiente del entorno Sugar. Un codigo Python autonomo 
(standalone) es mas facil y menos engorroso de testear y de depurar. 
Esto quedara claro cuando te empieces a testear tu primer Actividad. 

Cuantos mas bugs encuentres antes de transformar el codigo autonomo 
en Actividad, mejor. De hecho, es una buena idea mantener la version 
autonoma de tu programa incluso despues de ya tener la version 
Actividad bien encaminada. Yo use una version autonoma de Read 
Etexts cuando agregue la opcion resaltador en el conversor texto-voz. 
Hacer esto me ahorro muchfsimo tiempo porque estaba definiendo 
cosas sobre la marcha y la agilidad era un factor especialmente 
importante. 

Nuestro primer ejempio se basara sobre la Actividad Read Etexts tal y 
como la escribi. 

Heredar la clase desde sugar .activity .Activity class 

Ahora, convertiremos nuestro codigo Python autonomo en una Actividad 
sugar. Para esto, hay que entender el concepto de herencia. Decimos 
herencia, en la vida diaria, cuando obtenemos de los padres cosas para 
las que no trabajamos. Un rey que guia a su hijo a la ventana del castillo 
y dice "iUn dia esto sera tuyol", es herencia. 

En el mundo de las computadoras los programas pueden tener padres y 
heredar cosas de ellos. En vez de heredar propiedades, heredan codigo. 
Hay una pieza de codigo Python llamada sugar. activity. Activity que es el 
mejor padre que una Activity puede querer tener, y nosotros somos los 
que vamos a convencerle de que adopte a nuestro programa. No 
significa que nuestro programa no tenga que trabajar nunca mas, pero 
si, que va a trabajar mucho menos. 

Empaquetar la Actividad 

Ahora debemos empaquetar el codigo para convertirlo en algo que 
pueda correr dentro de Sugar y sea distribuido como archivo .xo. Esta 
etapa va implicar establecer MANIFEST, activity. info, setup. py y tambien 
disehar en Inskcape un icono compatible. 
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Agregar detalles 

Cualquier Actividad va a heredar la barra de herramientas (toolbar) 
basica. En la mayoria de los casos esta no es suficiente y se necesita 
alguna toolbar a medida. Estas adecuaciones deben integrarse bien, de 
modo que las barras disparen acciones sobre la Actividad y a su vez 
reflejen en el estado de la barra lo que sucede fuera de ella. 

Veremos, ademas del agregado de barras, algunas otras formas de 
poner a punto tu Actividad. 

Poner el codigo del proyecto en el controlador de 
versiones 

A esta altura en que ya tenemos una cantidad suficiente de codigo 
escrito, vale la pena protegerlo y compartirlo. Para esto precisamos 
crear un repositorio Git donde agregar nuestro codigo. Mas adelante 
vamos a volver a las basicas sobre el uso de Git. 

Internacionalizarse con Pootle 

Con el codigo salvado en Git podemos reclamar la ayuda de nuestro 
primer colaborador: el sistema de traduccion Pootle. Con un minimo 
trabajo de armado podemos conseguir voluntarios para internacionalizar 
nuestra Actividad. 

Distribuir la Actividad 

Para esta tarea simplemente tomaremos nuestra Actividad y la 
agregaremos en http://activities.sugarlabs.org junto al codigo fuente de 
modo que pueda ser incluida en otras distribuciones de Linux. 

Agregar colaboracion 

Ahora hay que agregar codigo para colaboracion, por ejempio para 
compartir los e-books con el Grupo y el Vecindario. 

Agregar texto hablado 

Lo siguiente es Texto hablado con resaltador de palabras. iNuestro 
pequeho proyecto sera todo un exitol- 
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1. NT: "Kindle-killer" en el original. 

2. Traducido Ana Cichero Uruguay- 
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/ • Un programa Python autonomo para 
leer Etexts 

El programa 

Nuestro programa de ejempio esta basado en la primera Actividad que 
escribi, Read Etexts. Es un programa para leer e-books gratuitos. 

La mejor y mas antigua fuente de e-books gratuitos es un sitio web 
llamado Project Gutenberg (http://www.gutenberg.org/wiki/Main_Page ). 
Ellos crean libros en formato de texto piano, en otras palabras, el tipo de 
archivo que podrias crear si escribieras un libro en Notepad y pulsaras la 
tecia Enter al final de cada linea. Ellos tienen miles de libros que no 
tienen derechos de autor, incluyendo algunos de los mejores jamas 
escritos. Antes de leer mas, ve a ese sitio web y escoge un libro que te 
interese. Echa un vistazo a la lista "Top 100" para ver los libros y los 
autores mas populares. 

El programa que vamos a crear va a leer libros en formato de texto 
piano . 

Existe un repositorio de Git que contiene todos los ejemplos de codigo de 
este libro. Una vez que hayas instalado Git puedes copiar el repositorio a 
tu computadora con este comando: 

git clone git : //git . sugarlabs .org/\ 

myo- sugar -activities -examples/mainline .git 

El codigo para nuestro programa Python independiente se encuentra en 
el directorio Make_Standalone_Python en un archivo llamado 
Read Etexts. py. Se ve asi: 

#! /usr/bin/env python 
import sys 
import OS 
import zipfile 
import pygtk 
import gtk 
import getopt 
import pango 

page=0 
PAGE_SIZE = 45 

class ReadEtexts( ) : 

def keypress_cb(self , widget, event): 

"Respond when the user presses one of the arrow keys" 
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keyname = gtk . gdk. keyval_name(event . keyval) 
if keyname == 'plus': 

self . font_increase( ) 

return True 
if keyname == 'minus': 

self . font_decrease( ) 

return True 
if keyname == 'Page_Up' : 

self . page_previous( ) 

return True 
if keyname == 'Page_Down': 

self . page_next( ) 

return True 
if keyname == 'Up' or keyname == 'KP_Up' \ 
or keyname == 'KP_Left': 

self . scroll_up( ) 

return True 
if keyname == 'Down' or keyname == ' KP_Down ' \ 
or keyname == 'KP_Right': 

self . scroll_down( ) 

return True 
return False 

def page_previous(self ) : 
global page 
page=page-l 
if page < 0: page=0 
self . show_page(page) 
v_adjustment = \ 

self . scrolled_window. get_vadjustment( ) 
v_adjustment .value = v_adjustment . upper - \ 

v_ad just men t . page_size 

def page_next (self ) : 
global page 
page=page+l 

if page >= len(self . page_index) : page=0 
self . show_page(page) 
v_adjustment = \ 

self . scrolled_window. get_vadjustment( ) 
v_adjustment .value = v_adjustment . lower 

def font_decrease(self ) : 

font_size = self . f ont_desc . get_size( ) / 1024 
font_size = font_size - 1 
if font_size < 1: 
font_size = 1 
self .font_desc. set_size(font_size * 1024) 
self . textview.modify_font (self . font_desc) 

def font_increase(self ) : 

font_size = self . f ont_desc .get_size( ) / 1024 
font_size = font_size + 1 
self .font_desc. set_size(font_size * 1024) 
self . textview.modify_font (self . font_desc) 

def scroll_down(self ) : 
v_adjustment = \ 

self. scrolled_window. get_vadjustment( ) 
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if v_adjustment . value == v_adjustment . upper - \ 
v_adjustment . page_size : 
self . page_next( ) 
return 
if v_adjustment .value < v_adjustment . upper -\ 
v_adjustment . page_size: 
new_value = v_adjustment .value + \ 

v_adjustment . step_increment 
if new_value > v_adjustment . upper -\ 
v_adjustment . page_size : 
new_value = v_adjustment . upper -\ 
v_adjustment . page_size 
v_adjustment .value = new_value 

def scroll_up(self ) : 
v_adjustment = \ 

self . scrolled_window. get_vad just men t( ) 
if v_adjustment . value == v_adjustment . lower : 
self . page_previous( ) 
return 
if v_adjustment .value > v_adjustment . lower : 
new_value = v_adjustment .value - \ 

v_adjustment . step_increment 
if new_value < v_adjustment . lower : 
new_value = v_adjustment .lower 
v_adjustment .value = new_value 

def show_page(self , page_number) : 

global PAGE_SIZE, current_word 

position = self . page_index[page_number] 

self .etext_file. seek(position) 

linecount = 

label_text = '\n\n\n' 

textbuffer = self . textview. get_buffer( ) 

while linecount < PAGE_SIZE: 

line = self .etext_file. readline( ) 
label_text = label_text + unicode(line, 

'iso-8859-1' ) 
linecount = linecount + 1 

label_text = label_text + '\n\n\n' 

textbuffer. set_text(label_text) 

self. textview. set_buffer(textbuffer) 

def save_extracted_f ile(self , zipfile, filename): 

"Extract the file to a temp directory for viewing' 
filebytes = zipfile . read(filename) 
f = open("/tmp/" + filename, 'w') 
try: 

f.write(file bytes) 
finally: 

f . close 

def read_file(self , filename): 
"Read the Etext file" 
global PAGE_SIZE 

if zipfile .is_zipfile(filename) : 

self.zf = zipfile .ZipFile(filename, 'r') 
self . book_files = self .zf . namelist( ) 
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self . save_extracted_file(self . zf , 

self .book_f lies [0] ) 
currentFileName = "/tmp/" + self . book_files[0] 
else : 

currentFileName = filename 

self .etext_file = open(currentFileName, "r" ) 

self . page_index = [ ] 

linecount = 

while self . etext_f ile : 

line = self .etext_file . readline( ) 
if not line: 

break 
linecount = linecount + 1 
if linecount >= PAGE_SIZE: 

position = self . etext_file. tell() 
self. page_index. append (posit ion) 
linecount = 
if filename . endswith( ". zip" ) : 
OS . remove (currentFileName) 

def destroy_cb(self , widget, data=None): 
gtk.main_quit( ) 

def main(self, file_path): 

self. window = gtk.Window(gtk.WINDOW_TOPLEVEL) 

self.window.connect( "destroy", self. destroy_cb) 

self .window. set_title( "Read Etexts" ) 

self .window. set_size_request (640, 480) 

self .window. set_border_width(0) 

self . read_file(file_path) 

self . scrolled_window = gtk .ScrolledWindow( 

hadjustment=None, vadjustment=None) 
self . textview = gtk .TextView( ) 
self.textview. set_editable( False) 
self. textview. set_lef t_margin(50) 
self. textview. set_cur so r_visible( False) 
self. textview. connect( "key_press_event", 

self . keypress_cb) 
buffer = self . textview. get_buffer( ) 
self .font_desc = pango . FontDescription("sans 12") 
font_size = self . f ont_desc .get_size( ) 
self . textview. modif y_f on t (self . font_desc) 
self . show_page(0) 

self. scrolled_window. add (self .textview) 
self.window.add(self. scrolled_window) 
self. textview. show() 
self . scrolled_window. show( ) 
v_adjustment = \ 

self . scrolled_window. get_vadjustment( ) 
self .window. show ( ) 
gtk.main( ) 

if name == " main " : 

try: 

opts, args = getopt . getopt(sys . argv[l: ] , "") 
ReadEtexts().main(args[0]) 
except getopt .error, msg: 
print msg 
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print "This program has no options" 
sys . exit(2) 



Ejecutar el programa 



Para ejecutar el programa primero debes hacerlo ejecutable. Solo tienes 
que hacer esto una vez: 

chmod 755 ReadEtexts . py 

Para este ejempio he descargado el archivo de Pride and Prejudice. El 

programa trabaja con cualquiera de los formatos de texto piano, puede 
ser texto sin compresion o un archivo Zip. El archivo zip se llama 
1342.zip, y podemos leer el libro ejecutando este archivo desde una 
terminal: 

. /ReadEtexts. py 1342.zip 

Asi es como se ve el programa en accion: 



Read EtcKts 



Produced by Anonymous Volunteers 



PRIDEAND PREJUDICE 
By Jane Austen 

Chapter 1 



It is a truth universally acknowledged, that a single man in possession 
of a good fortune, must be in want of a wife, 

However little known the feelings or views of such a man may be on his 
first entering a neighbourhood, this truth is so well fixed in the minds 



EL 



ti 
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^Como funciona el programa? 



Este programa lee el archivo de texto que contiene el libro y lo divide en 
paginas de 45 lineas cada una. Tenemos que hacer esto, porque el 
componente gtk.TextView que usamos para ver el texto necesitaria una 
gran cantidad de memoria para desplazarse por todo el libro y bajaria el 
rendimiento. Una segunda razon es que queremos hacer la lectura del 
libro electronico lo mas parecida posible a la de un libro normal, y los 
libros normales tienen paginas. Si un profesor asigna la lectura de un 
libro podria decir leer las paginas 35 a 50 para manana". Por ultimo, 
queremos que este programa recuerde en que pagina dejaste de leer y 
te lleve de vuelta a esa pagina la proxima vez que leas el libro. (El 
programa que tenemos aun no lo hace). 

Para desplazarnos por el libro usamos acceso aleatorio para leer el 
archivo. Para entender lo que significa acceso aleatorio a un archivo, 
considera una cinta VHS y un DVD. Para llegar a una cierta escena en 
una cinta VHS tienes que pasar por todas las escenas que hay antes que 
ella, en orden. A pesar de que lo haces a gran velocidad, aun tienes que 
mirar todas para encontrar el lugar en que quieres empezar a ver. Este 
es el acceso secuencial. Por otro lado un DVD tiene paradas por capitulo 
y, posiblemente, un menu de capitulos. Usando el menu de capitulos 
puedes ver cualquier escena en la pelicula de inmediato, y puedes saltar 
como quieras. Este es el acceso aleatorio o al azar, y el menu de 
capitulos es como un fndice. Por supuesto, tambien puedes acceder al 
material en un DVD de forma secuencial . 

Necesitamos acceso aleatorio para saltar a cualquier pagina que 
queramos, y necesitamos un fndice para que sepamos donde comienza 
cada pagina. Creamos el fndice leyendo el archivo completo una Ifnea a 
la vez. Cada 45 Ifneas creamos una nota con la cantidad de caracteres 
que se han introducido en el archivo y almacenamos esta informacion 
en una lista de Python. Despues volvemos al principio del archivo y 
mostramos la primera pagina. Cuando el usuario del programa va a la 
pagina siguiente o anterior, averiguamos cual sera el nuevo numero de 
pagina y buscamos esa pagina en el registro de la lista. Esto nos dice que 
la pagina comienza en el caracter 4200 del archivo. Nosotros usamos 
seek en el archivo para ir a ese caracter y, a continuacion, leemos 45 
Ifneas partiendo de ese punto y las cargamos en TextView. 
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Cuando ejecutes este programa fijate lo rapido que es. Los programas 
Python toman mas tiempo para ejecutar una linea de codigo del que 
tomarian en un lenguaje compilado, pero eso no importa en este 
programa, ya que el trabajo pesado es realizado por TextView que fue 
creado en un lenguaje compilado. Las partes de Python no hacen 
demasiado, asi que el programa no demora mucho tiempo en 
ejecutarlas. 

Sugar utiliza mucho Python, no solo para las Actividades, sino tambien 
para el entorno Sugar en si mismo. Puedes leer en algun lado que usar 
tanto Python es un "desastre" para el rendimiento. No lo creas. 

No hay lenguajes de programacion lentos, solo programadores lentos. 
1 

1. Traducido Santiago Zito Uruguay— 
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O • Heredar una Actividad desde 
sugar.activity .Activity 

python orientado a objetos 

Python permite dos estilos de programacion: procedural y orientada a 

objetos. La programacion procedural es cuando se tienen datos de 
entrada, se procesan, y se produce una salida. Si quieres calcular todos 
los numeros primos menores a cien o convertir un archivo de Word a 
texto piano, probabiemente uses ei estiio procedural. 

Los programas orientados a objetos estan construidos a partir de unas 
unidades iiamadas objetos. Un objeto se describe como una coieccion de 
campos atributos que contienen datos y metodos para iiacer cosas con 
datos. Ademas de ejecutar trabajo y guardar datos, ios objetos pueden 
mandarse mensajes entre si. 

Considera un programa que procese paiabras. No tiene soio una 
entrada, aigunos procesos y una saiida. Puede recibir datos dei teciado, 
de ios botones dei mouse, dei movimiento dei mouse, de ia impresora, 
etc. Un procesador de paiabras tambien puede editar varios documentos 
a ia vez. Cuaiquier programa con una interfaz grafica puede 
naturaimente ser programado mediante orientacion a objetos. 

Los objetos estan descriptos por clases. Cuando creas un objeto, estas 
creando una instancia de una ciase. 

Hay otra cosa que una ciase puede iiacer, que es heredar metodos y 
atributos de otra ciase. Cuando defines una ciase, puedes decir que 
extiende otra ciase, y ai iiacer eso tu ciase tiene toda ia funcionaiidad 
de ia otra ciase mas su propia funcionaiidad. La ciase extendida se 
vueive su padre. 

Todas ias Actividades Sugar extienden una ciase de Pytiion iiamada 
sugar.activity .Activity. Esta ciase provee metodos que todas ias 
Actividades precisan. Ademas de eso, iiay metodos que puedes 
sobrescribir en tu ciase, que ia ciase padre iiamara cuando precise. Para 
ei escritor principiante de Actividades tres metodos son importantes: 

__init__() 

Este metodo se iiama cuando ia actividad se inicia. Aqui es donde creas 
ia interfaz para tu Actividad, inciuyendo ias barras de iierramientas. 
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read_file(self, file_path) 

Este metodo se llama cuando retomas una Actividad guardada en el 

Diario. Se llama luego de llamar al metodo init (). El parametro 

file_path contiene el nombre de una copia temporal del archivo en el 
Diario. Este archivo se elimina al finalizar el metodo, pero como Sugar 
funciona sobre Linux, si abres un archivo para leer, tu programa puede 
continuar leyendolo aun despues de ser eliminado, el archivo no se 
desaparece hasta que lo cierres. 

write_file(self, file_path) 

Este metodo es llamado cuando una Actividad actualiza la entrada en el 
Diario. Al igual que read_file() tu Actividad no trabaja directamente con 
el Diario. En su lugar abre el archivo nombrado en el file_path para 
salida y escribe en el. Ese archivo a su vez es copiado al Diario. 

Hay tres motivos que pueden causar que write_file() se ejecute: 

• Tu Actividad cierra 

• Alguien presiona el boton Keep en la barra de herramientas de la 
Actividad 

• Tu Actividad deja de ser la Actividad activa, o alguien la mueve a 
otra vista. 

Ademas de actualizar el archivo en el Diario, los metodos read_file() y 
write_file() son usados para leer y actualizar los metadatos del archivo 
en el Diario. 

Cuando convertimos nuestro programa de Python en una Actividad, 
sacamos mucho del codigo que escribimos y lo remplazaremos con 
codigo heredado de la clase sugar. activity. Activity. 

Extendiendo la clase Actividad 

Aqui hay una version de nuestro programa que extiende la Actividad. 
Puede ser encontrada en el repositorio Git en el directorio 
InheritFromsugar.activity.Activity con el nombre 
ReadEtextsActivity.py: 

import sys 

import OS 

import zipfile 

import pygtk 

import gtk 

import pango 

from sugar . activity import activity 
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from sugar . graphics import style 

page=0 
PAGE_SIZE = 45 

class ReadEtextsActivity(activity .Activity) : 

def init (self, handle): 

"The entry point to the Activity" 

global page 

activity .Activity . init (self, handle) 

toolbox = activity .ActivityToolbox(self) 
activity_toolbar = toolbox. get_activity_toolbar( ) 
activity_toolbar . keep . props .visible = False 
activity_toolbar . share . props .visible = False 
self . set_toolbox( toolbox) 

toolbox. show( ) 

self . scrolled_window = gtk.ScrolledWindow( ) 

self . scrolled_window. set_policy(gtk . POLICY_NEVER, 

gt k . POLICY_AUTOMATIC ) 
self . scrolled_window. props . shadow_type = \ 

gtk.SHADOW_NONE 

self . textview = gtk .TextView( ) 
self.textview. set_editable( False) 
self. text view. set_cur so r_visible( False) 
self. textview. set_lef t_margin(50) 
self. textview. connect( "key_press_event", 
self . keypress_cb) 

self . scrolled_window. add (self .textview) 

self . set_canvas(self . scrolled_window) 

self. textview. show() 

self . scrolled_window. show( ) 

page = 

self. textview. grab_focus( ) 

self . font_desc = pango . FontDescription( "sans %d" % 

style. zoom(10) ) 
self . textview. modif y_f on t (self . font_desc) 

def keypress_cb(self , widget, event): 

"Respond when the user presses one of the arrow keys" 

keyname = gtk . gdk. keyval_name(event . keyval) 

print keyname 

if keyname == 'plus': 

self . font_increase( ) 

return True 
if keyname == 'minus': 

self . font_decrease( ) 

return True 
if keyname == 'Page_Up' : 

self . page_previous( ) 

return True 
if keyname == 'Page_Down': 

self . page_next( ) 

return True 
if keyname == 'Up' or keyname == 'KP_Up' \ 
or keyname == 'KP_Left': 
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self . scroll_up( ) 

return True 
if keyname == 'Down' or keyname == ' KP_Down ' \ 
or keyname == 'KP_Right': 

self . scroll_down( ) 

return True 
return False 

def page_previous(self ) : 
global page 
page=page-l 
if page < 0: page=0 
self. show_page(page) 
v_adjustment = \ 

self . scrolled_window. get_vad just men t( ) 
v_adjustment .value = v_adjustment . upper -\ 

v_adjustment . page_size 

def page_next (self ) : 
global page 
page=page+l 

if page >= len(self . page_index) : page=0 
self. show_page(page) 
v_adjustment = \ 

self . scrolled_window. get_vad just men t( ) 
v_adjustment .value = v_adjustment . lower 

def font_decrease(self ) : 

font_size = self . font_desc . get_size( ) / 1024 
font_size = font_size - 1 
if font_size < 1: 
font_size = 1 
self .font_desc . set_size(font_size * 1024) 
self. text view. modify_font (self . f ont_desc) 

def font_increase(self ) : 

font_size = self . font_desc . get_size( ) / 1024 
font_size = font_size + 1 
self .font_desc . set_size(font_size * 1024) 
self. text view. modify_font (self . f ont_desc) 

def scroll_down(self ) : 
v_adjustment = \ 

self . scrolled_window. get_vad just men t( ) 
if v_adjustment . value == v_adjustment . upper - ^ 
v_adjustment . page_size : 
self . page_next( ) 
return 
if v_adjustment .value < v_adjustment . upper -\ 
v_adjustment . page_size: 
new_value = v_adjustment .value +\ 

v_adjustment . step_increment 
if new_value > v_adjustment . upper -\ 
v_adjustment . page_size : 
new_value = v_adjustment . upper -\ 
v_adjustment . page_size 
v_adjustment .value = new_value 

def scroll_up(self ) : 



39 



v_adjustment = \ 

self . scrolled_window. get_vadjustment( ) 
if v_adjustment .value == v_adjustment .lower : 

self . page_previous( ) 

return 
if v_adjustment .value > v_adjustment . lower : 

new_value = v_adjustment .value - \ 
v_adjustment . step_increment 

if new_value < v_adjustment . lower : 
new_value = v_adjustment . lower 

v_adjustment .value = new_value 

def show_page(self , page_number) : 

global PAGE_SIZE, current_word 

position = self . page_index[page_number] 

self . etext_file .seek(position) 

linecount = 

label_text = '\n\n\n' 

textbuffer = self . textview.get_buffer( ) 

while linecount < PAGE_SIZE: 

line = self .etext_file . readline( ) 
label_text = label_text + unicode(line, 

'iso-8859-1' ) 
linecount = linecount + 1 

label_text = label_text + '\n\n\n' 

textbuffer. set_text(label_text ) 

self.textview. set_buffer( textbuffer) 

def save_extracted_file(self , zipfile, filename): 

"Extract the file to a temp directory for viewing" 
filebytes = zipfile . read(filename) 
outfn = self .make_new_filename(f ilename) 
if (outfn == ' ' ) : 

return False 
f = open(os . path . join(self .get_activity_root ( ) , 

'instance', outfn), 'w') 
try: 

f.write(filebytes) 
finally: 

f . close 

def read_file(self , filename): 
"Read the Etext file" 
global PAGE_SIZE 

if zipfile . is_zipfile(f ilename) : 

self.zf = zipfile .ZipFile(filename, 'r') 
self . book_f iles = self .zf . namelist( ) 
self . save_extracted_file(self . zf , 

self .book_f iles [0] ) 
currentFileName = os . path . join( 
self. get_activity_root ( ) , 
'instance', self . book_files[0] ) 
else : 

currentFileName = filename 

self .etext_file = open(currentFileName, "r" ) 
self . page_index = [ ] 
linecount = 
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while self . etext_file : 

line = self .etext_file. readline( ) 
if not line: 

break 
linecount = linecount + 1 
if linecount >= PAGE_SIZE: 

position = self .etext_file. tell( ) 
self. page_ind ex. append (posit ion) 
linecount = 
if filename . endswith( ". zip" ) : 

os.remove(currentFileName) 
self. show_page(0) 

def inake_new_f ilename(self , filename): 

partition_tuple = filename. rpartition( '/' ) 
return partition_tuple[2] 



Este programa tiene algunas diferencias con la version independiente. 
Para empezar, se ha quitado la linea: 

#! /usr/bin/env python 

Ya no estamos ejecutando el programa directamente desde el interprete 
de Python. Ahora Sugar lo esta ejecutando como una Actividad. Casi todo 

lo que estaba dentro del metodo main() fue movido al metodo init () 

y se ha quitado main(). 

Nota tambien que ha cambiado la declaracion de la clase: 

class ReadEtexts Activity (activity .Activity) 

Esta linea nos dice que la clase ReadEtextsActivity extiende la clase 
sugar. activity.Activity y como resultado hereda el codigo de esa clase. 
Por lo tanto no necesitamos definir una funcion, ni en bucle principal de 
GTK, el codigo de la clase que extendemos hara todo eso. 

Aunque ganamos mucho de esta herencia, tambien perdemos algo: una 
barra de titulo para la aplicacion principal. En un ambiente grafico, un 
software llamado gestor de ventanas es responsable de ponerle hordes 
a las ventanas, permitir que cambien de tamaho, reducirlas a iconos, 
maximizarlas, etc. Sugar utiliza un gestor de ventanas llamado 
Matchbox que hace que cada ventana ocupe el espacio completo y no le 
pone borde, barra de titulo, ni ningun otro tipo de decoracion de 
ventana. Como resultado, no podemos cerrar nuestra aplicacion 
haciendo click en la "X". Para compensar esto tenemos que tener una 
barra de herramientas que contenga un boton para cerrar. Es asi que 
cada Actividad tiene una barra de herramientas de Actividad que 
contiene algunos botones y controles estandar. Si te fijas en el codigo 
veras que estoy escondiendo algunos controles para los cuales no 
tenemos uso todavia. 
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El metodo read_file() no es llamado mas desde el metodo main() y no 
parece ser llamado desde ningun lugar del programa. Sin embargo es 
llamado por parte del codigo que heredamos de la clase padre. 

Similarmente los metodos init () y write_file() (en caso de tenerlo) 

son llamados por la clase padre. 

El lector especialmente observador podra notar otro cambio. Nuestro 
programa original creaba un archivo temporal cuando necesitaba 
extraer algo de un archivo ZIP. Ponia ese archivo en un directorio 
llamado /tmp. Nuestra nueva Actividad todavia crea el archivo pero lo 
pone en un directorio diferente, uno especifico de la Actividad. 

Toda escritura al sistema de archivos esta restringido a subdirectorios 
de la direccion dada por self.get_activity_root(). Este metodo dara un 
directorio que pertenece solo a tu Actividad. Contendra tres 
subdirectorios con distintas politicas. 

data 

Este subdirectorio es usado para datos como los archivos de 
configuracion. Los archivos guardados aca sobreviviran reinicios y 
actualizaciones del OS. 

tmp 

Este directorio es similar al directorio /tmp, siendo respaldado por 
RAM. Puede ser tan pequeho como 1 MB. Este directorio es eliminado 
cuando la Actividad se cierra. 

instance 

Este directorio es similar al directorio tmp, siendo respaldado por el 
disco duro en vez de la RAM. Es unico por instancia. Es usado para 
transferencias con el Diario. Este directorio es eliminado cuando la 
Actividad se cierra. 

Hacer estos cambios al codigo no es suficiente para hacer que nuestro 
programa sea una Actividad. Tenemos que hacer un trabajo de 
empaquetamiento y configurarlo para que sea ejecutado por el 
emulador de Sugar. Tambien necesitamos aprender como ejecutar el 
emulador de Sugar. iEsto viene a continuacion! 
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Heredar una Actividad desde 
sugar.activity .Activity 

python orientado a objetos 

Python permite dos estilos de programacion: procedural y orientada a 
objetos. La programacion procedural es cuando se tienen datos de 
entrada, se procesan, y se produce una salida. Si quieres calcular todos 
los numeros primos menores a cien o convertir un archivo de Word a 
texto piano, probablemente uses el estilo procedural. 

Los programas orientados a objetos estan construidos a partir de unas 
unidades llamadas objetos. Un objeto se describe como una coleccion de 
campos atributos que contienen datos y metodos para hacer cosas con 
datos. Ademas de ejecutar trabajo y guardar datos, los objetos pueden 
mandarse mensajes entre si. 

Considera un programa que procese palabras. No tiene solo una 
entrada, algunos procesos y una salida. Puede recibir datos del teclado, 
de los botones del mouse, del movimiento del mouse, de la impresora, 
etc. Un procesador de palabras tambien puede editar varios documentos 
a la vez. Cualquier programa con una interfaz grafica puede 
naturalmente ser programado mediante orientacion a objetos. 

Los objetos estan descriptos por clases. Cuando creas un objeto, estas 
creando una instancia de una clase. 

Hay otra cosa que una clase puede hacer, que es heredar metodos y 
atributos de otra clase. Cuando defines una clase, puedes decir que 
extiende otra clase, y al hacer eso tu clase tiene toda la funcionalidad 
de la otra clase mas su propia funcionalidad. La clase extendida se 
vuelve su padre. 

Todas las Actividades Sugar extienden una clase de Python llamada 
sugar. activity.Activity. Esta clase provee metodos que todas las 
Actividades precisan. Ademas de eso, hay metodos que puedes 
sobrescribir en tu clase, que la clase padre llamara cuando precise. Para 
el escritor principiante de Actividades tres metodos son importantes: 

__init__() 

Este metodo se llama cuando la actividad se inicia. Aqui es donde creas 
la interfaz para tu Actividad, incluyendo las barras de herramientas. 
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read_file(self, file_path) 

Este metodo se llama cuando retomas una Actividad guardada en el 

Diario. Se llama luego de llamar al metodo init (). El parametro 

file_path contiene el nombre de una copia temporal del archivo en el 
Diario. Este archivo se elimina al finalizar el metodo, pero como Sugar 
funciona sobre Linux, si abres un archivo para leer, tu programa puede 
continuar leyendolo aun despues de ser eliminado, el archivo no se 
desaparece hasta que lo cierres. 

write_file(self, file_path) 

Este metodo es llamado cuando una Actividad actualiza la entrada en el 
Diario. Al igual que read_file() tu Actividad no trabaja directamente con 
el Diario. En su lugar abre el archivo nombrado en el file_path para 
salida y escribe en el. Ese archivo a su vez es copiado al Diario. 

Hay tres motivos que pueden causar que write_file() se ejecute: 

• Tu Actividad cierra 

• Alguien presiona el boton Keep en la barra de herramientas de la 
Actividad 

• Tu Actividad deja de ser la Actividad activa, o alguien la mueve a 
otra vista. 

Ademas de actualizar el archivo en el Diario, los metodos read_file() y 
write_file() son usados para leer y actualizar los metadatos del archivo 
en el Diario. 

Cuando convertimos nuestro programa de Python en una Actividad, 
sacamos mucho del codigo que escribimos y lo remplazaremos con 
codigo heredado de la clase sugar. activity.Activity. 

Extendiendo la clase Actividad 

Aqui hay una version de nuestro programa que extiende la Actividad. 
Puede ser encontrada en el repositorio Git en el directorio 
InheritFromsugar. activity.Activity con el nombre 
ReadEtextsActivity.py: 

import sys 

import OS 

import zipfile 

import pygtk 

import gtk 

import pango 

from sugar . activity import activity 
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from sugar . graphics import style 

page=0 
PAGE_SIZE = 45 

class ReadEtextsActivity(activity .Activity) : 

def init (self, handle): 

"The entry point to the Activity" 

global page 

activity .Activity . init (self, handle) 

toolbox = activity .ActivityToolbox(self) 
activity_toolbar = toolbox. get_activity_toolbar( ) 
activity_toolbar . keep . props .visible = False 
activity_toolbar . share . props .visible = False 
self. set_toolbox( tool box) 

toolbox. show( ) 

self . scrolled_window = gtk.ScrolledWindow( ) 

self . scrolled_window. set_policy (gtk . POLICY_NEVER, 

gtk.POLICY_AUTOMATIC) 
self . scrolled_window. props . shadow_type = \ 

gtk.SHADOW_NONE 

self . textview = gtk .TextView( ) 
self. textview. set_editable(False) 
self. textview. set_cur so r_visible( False) 
self. textview. set_lef t_margin(50) 
self. textview. connect ( "key_p res s_e vent", 
self . keypress_cb) 

self. scrolled_window. ad d(self. textview) 

self. set_canvas(self . scrolled_window) 

self. textview. show( ) 

self. scrolled_window. show( ) 

page = 

self. textview. grab_focus( ) 

self .font_desc = pango . FontDescription( "sans %d" % 

style. zoom(10) ) 
self. textview. modify_font (self . f ont_desc) 

def keypress_cb(self , widget, event): 

"Respond when the user presses one of the arrow keys" 

keyname = gtk . gdk . keyval_name(event . keyval) 

print keyname 

if keyname == 'plus': 

self . f ont_increase( ) 

return True 
if keyname == 'minus': 

self . f ont_decrease( ) 

return True 
if keyname == 'Page_Up' : 

self . page_previous( ) 

return True 
if keyname == 'Page_Down': 

self . page_next( ) 

return True 
if keyname == 'Up' or keyname == 'KP_Up' \ 
or keyname == 'KP_Left': 



45 



self . scroll_up( ) 

return True 
if keyname == 'Down' or keyname == ' KP_Down ' \ 
or keyname == 'KP_Right': 

self . scroll_down( ) 

return True 
return False 

def page_previous(self ) : 
global page 
page=page-l 
if page < 0: page=0 
self . show_page(page) 
v_adjustment = \ 

self . scrolled_window. get_vadjustment( ) 
v_adjustment . value = v_adjustment . upper -\ 

v_ad just men t . page_size 

def page_next (self ) : 
global page 
page=page+l 

if page >= len(self . page_index) : page=0 
self . show_page(page) 
v_adjustment = \ 

self . scrolled_window. get_vadjustment( ) 
v_adjustment .value = v_adjustment .lower 

def font_decrease(self ) : 

font_size = self . f ont_desc . get_size( ) / 1024 
font_size = font_size - 1 
if font_size < 1: 
font_size = 1 
self .font_desc . set_size(font_size * 1024) 
self . textview.modify_font (self . font_desc) 

def font_increase(self ) : 

font_size = self . f ont_desc .get_size( ) / 1024 
font_size = font_size + 1 
self .font_desc . set_size(font_size * 1024) 
self . textview.modify_font (self . font_desc) 

def scroll_down(self ) : 
v_adjustment = \ 

self . scrolled_window. get_vadjustment( ) 
if v_adjustment .value == v_adjustment . upper - ^ 
v_adj ustment . page_size : 
self . page_next( ) 
return 
if v_adjustment .value < v_adjustment . upper -\ 
v_adj ustment . page_size : 
new_value = v_adjustment .value +\ 

v_adj ustment . step_increment 
if new_value > v_adjustment . upper -\ 
v_adj ustment . page_size : 
new_value = v_adjustment . upper -\ 
v_adj ustment . page_size 
v_adj ustment .value = new_value 

def scroll_up(self ) : 
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v_adjustment = \ 

self . scrolled_window. get_vadjustment( ) 
if v_adjustment .value == v_adjustment .lower : 

self . page_previous( ) 

return 
if v_adjustment . value > v_adjustment . lower : 

new_value = v_adjustment .value - \ 
v_adjustment . step_increment 

if new_value < v_adjustment . lower : 
new_value = v_adjustment . lower 

v_adjustment .value = new_value 

def show_page(self , page_number) : 

global PAGE_SIZE, current_word 

position = self . page_index[page_number] 

self .etext_file. seek(position) 

linecount = 

label_text = '\n\n\n' 

textbuffer = self . textview. get_buffer( ) 

while linecount < PAGE_SIZE: 

line = self .etext_file. readline( ) 
label_text = label_text + unicode(line, 

'iso-8859-1' ) 
linecount = linecount + 1 

label_text = label_text + '\n\n\n' 

textbuffer. set_text(label_text) 

self. textview. set_buffer(textbuffer) 

def save_extracted_f ile(self , zipfile, filename): 

"Extract the file to a temp directory for viewing' 
filebytes = zipfile . read(filename) 
outfn = self .make_new_filename(f ilename) 
if (outfn == ' ' ) : 

return False 
f = open(os . path . join(self . get_activity_root ( ), 

'instance', outfn), 'w') 
try: 

f.write(file bytes) 
finally: 

f . close 

def read_file(self , filename): 
"Read the Etext file" 
global PAGE_SIZE 

if zipfile .is_zipfile(filename) : 

self.zf = zipfile .ZipFile(filename, 'r') 
self . book_files = self . zf . namelist( ) 
self . save_extracted_file(self . zf , 

self .book_files[0] ) 
currentFileName = os . path . join( 
self. get_activity_root( ) , 
'instance', self . book_files[0] ) 
else: 

currentFileName = filename 

self .etext_file = open(currentFileName, "r" ) 
self . page_index = [ ] 
linecount = 
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while self . etext_f ile : 

line = self . etext_f ile . readline( ) 
if not line: 

break 
linecount = linecount + 1 
if linecount >= PAGE_SIZE: 

position = self .etext_file. tell( ) 
self. page_index. append (posit ion) 
linecount = 
if filename . endswith( ". zip" ) : 

OS . remove (curr en tFileName) 
self . show_page(0) 

def make_new_f ilename(self , filename): 

partition_tuple = filename . rpartition( '/' ) 
return partition_tuple[2] 



Este programa tiene algunas diferencias con la version independiente. 
Para empezar, se ha quitado la linea: 

#! /usr/bin/env python 

Ya no estamos ejecutando el programa directamente desde el interprete 
de Python. Ahora Sugar lo esta ejecutando como una Actividad. Casi todo 

lo que estaba dentro del metodo main() fue movido al metodo init () 

y se ha quitado main(). 

Nota tambien que ha cambiado la declaracion de la clase: 

class ReadEtexts Activity (activity .Activity) 

Esta linea nos dice que la clase ReadEtextsActivity extiende la clase 
sugar.activity .Activity y como resultado hereda el codigo de esa clase. 
Por lo tanto no necesitamos definir una funcion, ni un bucle principal de 
GTK, el codigo de la clase que extendemos hara todo eso. 

Aunque ganamos mucho de esta herencia, tambien perdemos algo: una 
barra de titulo para la aplicacion principal. En un ambiente grafico, un 
software llamado gestor de ventanas es responsable de ponerle hordes 
a las ventanas, permitir que cambien de tamaho, reducirlas a iconos, 
maximizarlas, etc. Sugar utiliza un gestor de ventanas llamado 
Matchbox que hace que cada ventana ocupe el espacio completo y no le 
pone borde, barra de titulo, ni ningun otro tipo de decoracion de 
ventana. Como resultado, no podemos cerrar nuestra aplicacion 
haciendo click en la "X". Para compensar esto tenemos que tener una 
barra de herramientas que contenga un boton para cerrar. Es asi que 
cada Actividad tiene una barra de herramientas de Actividad que 
contiene algunos botones y controles estandar. Si te fijas en el codigo 
veras que estoy escondiendo algunos controles para los cuales no 
tenemos uso todavia. 
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El metodo read_file() no es llamado mas desde el metodo mainO y no 
parece ser llamado desde ningun lugar del programa. Sin embargo es 
llamado por parte del codigo que heredamos de la clase padre. 

Similarmente los metodos init () y write_file() (en caso de tenerlo) 

son llamados por la clase padre. 

El lector especialmente observador podra notar otro cambio. Nuestro 
programa original creaba un archivo temporal cuando necesitaba 
extraer algo de un archivo ZIP. Ponia ese archivo en un directorio 
llamado /tmp. Nuestra nueva Actividad todavia crea el archivo pero lo 
pone en un directorio diferente, uno especifico de la Actividad. 

Toda escritura al sistema de archivos esta restringida a subdirectorios 
de la direccion dada por self.get_activity_root(). Este metodo dara un 
directorio que pertenece solo a tu Actividad. Contendra tres 
subdirectorios con distintas politicas. 

data 

Este subdirectorio es usado para datos como los archivos de 
configuracion. Los archivos guardados aca sobreviviran reinicios y 
actualizaciones del OS. 

tmp 

Este directorio es similar al directorio /tmp, siendo respaldado por 
RAM. Puede ser tan pequeho como 1 MB. Este directorio es eliminado 
cuando la Actividad se cierra. 

instance 

Este directorio es similar al directorio tmp, siendo respaldado por el 
disco duro en vez de la RAM. Es unico por instancia. Es usado para 
transferencias con el Diario. Este directorio es eliminado cuando la 
Actividad se cierra. 

Hacer estos cambios al codigo no es suficiente para hacer que nuestro 
programa sea una Actividad. Tenemos que hacer un trabajo de 
empaquetamiento y configurarlo para que sea ejecutado por el 
emulador de Sugar. Tambien necesitamos aprender como ejecutar el 
emulador de Sugar. iEsto viene a continuacion! 



1. Traducido Juan Michelini, Uruguay- 
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V« Empaquetar tu Actividad 



Agregar setup .py 

Siempre debes agregar el programa en Python llamado setup. py en el 
mismo directorio donde esta el programa con tu Actividad. Todo setup. py 
es exactamente igual a otro setup. py cualquiera. La copia que esta en 
nuestro repositorio Git se ve asi: 

#! /usr/bin/env python 

# Copyright (C) 2006, Red Hat, Inc. 
# 

# This program is free software; you can redistribute it 

# and/or modify it under the terms of the GNU General 

# Public License as published by the Free Software 

# Foundation; either version 2 of the License, or (at 

# your option) any later version. 
# 

# This program is distributed in the hope that it will 

# be useful, but WITHOUT ANY WARRANTY; without even 

# the implied warranty of MERCHANTABILITY or FITNESS 

# FOR A PARTICULAR PURPOSE. See the GNU General 

# Public License for more details. 
# 

# You should have received a copy of the GNU General 

# Public License along with this program; if not, 

# write to the Free Software Foundation, Inc., 

# 51 Franklin St, Fifth Floor, Boston, MA 

# 02110-1301 USA 

from sugar . activity import bundlebuilder 
bundle builder. start () 

Asegurate de copiar el texto integro que ves aqui encima, incluidos los 
comentarios. 

Sugar usa al programa setup. py para diversos fines. Si ejecutas setup. py 
por linea de comandos veras las opciones que te propone y entenderas 
que hacen. 

[jim§simmons bookexamples]$ . /setup. py 
/usr/lib/python2.6/site-packages/sugar/util.py:25: 
DeprecationWarning : the sha module is deprecated; 
use the hashlib module instead 

import sha 
Available commands: 

build Build generated files 

dev Setup for development 

dist_xo Create a xo bundle package 

dist_source Create a tar source package 
fix_manifest Add missing files to the manifest 
genpot Generate the gettext pot file 

install Install the activity in the system 
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(Type ". /setup. py <command> --help" for help about a 

particular command's options. 

NT: 

build Build(construir) genera archives 

dev Setup para development-desarrollo 

dist_xo Crea un paquete bundle xo 

dist_source Crea un paquete fuente tar 

fix_manifest Agrega los archives que faltan en el manifest 

genpot Genera el archive gettext pot 

install Instala la actividad en el sistema 

Estaremos ejecutando alguno de estos comandos mas tarde. No se 
preocupen por la advertencia DeprecationWarning. Este es un mensaje 
de Python para avisar que existe un procedimiento nuevo, que mejora el 
que estamos usando, pero el modo anterior siempre funciona. Es un 
error que viene del codigo mismo de Sugar y que sera corregido en 
alguna version posterior. 

Crear activity .info 

Ahora crearemos un directorio en el mismo lugar donde este nuestro 
programa (.py) y lo llamaremos activity. Dentro de ese directorio vamos 
crear el archivo llamado activity.info y a escribir en el las lineas que 
vemos aqui abajo. En este ejempio vemos las lineas correspondientes a 
mi primer Actividad. 

[Activity] 

name = Read ETexts II 

service_name = net . flossmanuals . ReadEtextsActivity 

icon = read-etexts 

exec = sugar-activity ReadEtextsActivity . ReadEtextsActivity 

show_launcher = no 

activity_version = 1 

mime_types = text/plain;application/zip 

license = GPLv2+ 
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Este archive es el que dice a Sugar como ejecutar cada Actividad. Las 
propiedades requeridas para este archive son: 



name 



service name 



icon 



exec 



show launcher 



activityversion 



mime_types 



license 



Es el nombre de tu Actividad tal y como lo vera el usuario. 

Es el nombre unico con el que Sugar refer! ra a tu Actividad. Toda 
entrada al Journal que tu Actividad registre tendra este nombre en 
su metadata, de modo que cuando alguien retome la entrada en el 
Journal, Sugar sabra que programa creo la entrada y lo usara para 
abrirla. 

Es el nombre del icono que creaste para tu Actividad. Como los 
iconos son siempre archivos .svg , el nombre del archivo en el 
ejempio es simplemente read-etexts.svg. 

Esto informa a Sugar como lanzar tu Actividad. Le dice que cree una 
instancia de la clase ReadEtextsActivity que encontrara en 
ReadEtextsActivity.py 

Hay dos formas comunes para lanzar una Actividad, cliquear sobre 
el fcono en la vista de Actividades o retomar la Actividad desde el 
Journal. No tiene sentido anadir un fcono a I anillo de Actividades 
para una Actividad como la de este ejempio. Esta solo puede ser 
retomada desde el Journal. 

Un entero que representa el numero de version de tu programa. La 
primer version sera 1, la siguiente 2 y de asi en mas. 

Generalmente al retomar una entrada del Diario, este lanza la 
Actividad que la creo. En el caso de entradas que no estan creadas 
por una Actividad, como en e-books, es necesario indicar de otra 
forma al Diario cual Actividad utilizar. Un tipo MIME es el nombre 
de un tipo corriente de archivo, por ejempio text/plain (texto piano) 
, text/html, application/zip y application/pdf. Con esta entrada 
estamos indicando al Diario que tipos maneja nuestro programa, en 
este ejempio textos pianos o empaquetados zip. 

Ser dueno de una computadora no es como tener un automovil. El 
dueno de un automovil puede comercializarlo como quiera. Puede 
venderlo, alquilarlo, destruirlo o lo que sea. Con un programa de 
una computadora siempre existe una licencia que indica a la 
persona lo que esta permitido hacer. La GPLv2+ es el estandar 
popular de licencias que puede ser usada para Actividades, y como 
este es mi programa, elijo GPLv2. Cuando estes pronto para 
comenzar a distribuir tus Actividades trendre mas que decir sobre 
licencias. 
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Crear un icono 

Necesitamos crear un icono llamado read-etexts.svg y guardarlo en el 
subdirectorio activity. Usaremos Inkscape para crear el icono. Con el 
menu New (Nuevo) en Inkscape seleccionamos icon_48x48. Esto nos 
dara un area con buenas medidas para dibujar. 

No hay que ser un experto para crear el icono. De hecho, cuanto mas 
simple sea el icono mejor. Al dibujar el icono recuerda el siguiente 
punteo: 

• Tu icono debe verse bien en muy distintos rangos de tamano, desde 
muy muy chico a grande. 

• Tiene que ser reconocible cuando es muy muy chico. 

• Solo puedes usar dos colores uno para el trazo (stroke) y otro para el 
color de relleno (fill). No importa cuales elijas porque Sugar 
necesita reemplazar tus opciones, asi que te conviene usar trazos 
negros y fondo bianco. 

• Un color de relleno solo aplica en un area donde el borde este 
cerrado. Si dibujas una caja y uno de las esquinas queda abierta 
esta no podra llenarse con color. Dibujar a mano alzada es solo para 
talentosos. Circunferencias, rectangulos y arcos son sencillos de 
dibujar en Inkscape asi que usalos cuando puedas. 

• Inkscape tambien dibuja cajas 3D usando dos puntos perspectivos. 
No los usen. Los iconos deben ser imagenes planas. El 3D luce mal 
en un icono. 

• Es realmente dificil tener una idea buena para el icono Una vez me 
entusiasme con una linda imagen de un mueble fichero para 
tarjetas de carton como icono para Get Internet Arcliive Boolcs. 

Pero claro, nadie de menos de cuarenta ahos ha visto un fichero asi 
y muy pocos entenderian entonces mi simbologia. 

Cuando termines de hacer tu icono deberas modificarlo para que Sugar 
trabaje con el. Especialmente se debe explicitar que Sugar puede usar 
su propia pareja de colores para el trazo (stroke) y el relleno (fill). SVG 
es un formato basado en XML, que es solo un texto con algunas 
etiquetas especiales. Esto significa que al terminar de editar la imagen 
en Inkscape la podemos cargar en Eric y editaria como archivo de texto. 

No voy a poner el archivo SVG entero en este capitulo porque la mayor 
parte queda Intacta, no hay que hacerle nada. La parte que debes 
modificar esta casi al principio. 



53 



Antes: 

<?xml version="l. 0" encoding="UTF-8" standalone="no"?> 
<!-- Created with Inkscape (http://www.inkscape.org/) --> 
<svg 

Despues: 

<?xml version="l. 0" ?> 

<!DOCTYPE svg PUBLIC '-//W3C//DTD SVG 1.1//EN' 

'http://www.w3.0rg/Graphics/SVG/l.l/DTD/svgll.dtd' [ 

<! ENTITY stroke_color "#000000"> 

<! ENTITY fill_COlor "#FFFFFF"> 
]><svg 

Ahora, en el cuerpo del documento habran varias referencias a filly a 
stroke como parte de un atributo llamado style. Cada linea o forma que 
dibujes tendra un texto como este: 

<rect 

style="fill:#ffffff ; stroke :#000000; stroke -opacity :l" 

id="rect904" 

Width="36. 142857" 

height="32. 142857" 

X="4. 1428571" 

y="7. 1428571" /> 

Deberas cambiar cada uno de esos textos para que se vean como este 
otro: 

<rect 

style="fill:&fill_color ; ; stroke :&stroke_color ; 
; stroke-opacity :1" 

id="rect904" 

Width="36. 142857" 

height="32. 142857" 

X="4. 1428571" 

y="7. 1428571" /> 

Importante. Notar que 6iStroke_color; y &fill_color; terminan ambas con 
punto-y-coma (;), y a la vez, punto-y-coma se usa para separar las 
propiedades de style. Esta es la causa de un error de principiante muy 
comun que es quitar el punto-y-coma de separacion porque dos punto-y- 
comas seguidos no se ven bien. No duden, ambos punto-y-comas 
(semicolons) en el mismo renglon son intencionales e indispensables. 
Tambien, notaras que el valor para style debe estar todo en una sola 
linea. Aca -en el libro- lo partimos para que calzara en la diagramacion 
de la hoja, no hagas esto en el archivo de tu icono. 

Armar el archivo MANIFEST 

Recordemos que setup. py tiene una opcion para actualizar el 
manifiesto. Hagamos la prueba: 
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. /setup. py fix_manifest 

/usr/lib/python2.6/site-packages/sugar/util.py:25: 
DeprecationWarning : the sha module is deprecated; 
use the hashlib module instead 

import sha 
WARNING : root :Missing po/ dir, cannot build_locale 
WARNING: root : Activity directory lacks a MANIFEST file. 

Efectivamente, esto construye un archive MANIFEST conteniendo todo lo 
que este en el directorio y en subdirectories. El directorio /po por el que 
protests, es el directorio que se usa para traducir la Actividad a distintos 
idionnas. Podennos ignorarlo por el momento. 

El archivo creado tendra algun contenido extra, del que podemos 
librarnos usando Eric. El archivo corregido debera verse simplemente 
asi: 

setup . py 

ReadEtextsActivity . py 
activity/ read -etexts.svg 
activity /activity. info 

Instalar la Actividad 

Solamente nos falta una cosa antes de poder probar nuestra Actividad 
en un emulador de Sugar. Nos falta instalarla. En este caso instalaria 
quiere decir crear un vinculo simbolico entre el directorio -/Activities/ y 
nuestro codigo. El simbolo ~ refiere siempre al directorio "hogar" del 
usuario bajo el que estemos corriendo Sugar y un vinculo simbolico es 
solo una forma de hacer que un archivo o carpeta parezca estar en mas 
de un lugar sin haberlo copiado. Crearemos este vinculo simbolico 
(symbolic link) usando nuevamente setup. py: 

. /setup. py dev 

Ejecutar nuestra Actividad 

Finalmente podemos ejecutar nuestra Actividad en Sugar. Para esto es 
necesario saber usar un emulador de Sugar. 

Fedora no proporciona una opcion de menu para la creacion del 
emulador, pero es facil agregarlo directamente. El comando a escribir es 
sencillo: 

sugar-emulator 

Si tu resolucion de pantalla fuera menor que la resolucion que el 
emulador Sugar usa por defecto, este se vera en modo pantalla 
completa. Esto no es conveniente para el testeo asi que deberas 
especificar tu propia resolucion: 
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sugar-emulator -i 800x600 

Senalemos que esta opcion esta disponible solo en Fedora 11 y 
posteriores. 

Cuando ejecutas el emulador se despliega una ventana y el entorno 
Sugar arranca adentro de ella. Se ve algo asi: 




Al ejecutar el emulador puede pasar que algunas teclas no funcionen 
bien. Esto se debe a errores (bugs) en el software Xephyr que es quien 
crea la ventana donde corre Sugar. A veces es dificil identificar la 
distribucion del teclado y algunas teclas se interpretan mal. Mis 
experiencias son con Fedora 11, las teclas de funcion no me anduvieron 
y para las flechas tuve que usar el teclado numerico. Logre recomponer 
las teclas de funcion incluyendo esta linea en -/.sugar/debug: 

run setxkbmap <keymap name> 

Esto necesita explicacion adicional. Primero, el simbolo "~" refiere al 
directorio hogar. Segundo, cualquier archivo que en Linux comience con 
un punto sera un archivo oculto, por lo tanto para verlo debemos usar la 
opcion de mostrar archivos ocultos en el navegador de archivos de 
GNOME. Finalmente en el <keymap name> es un codigo de pais con dos 
caracteres: us para Estados Unidos, fr para Francia, de para Alemania, 
etc. 
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Para probar esta Actividad vamos a necesitar tener un libro en el 
Journal, asi que usaremos la Actividad Browse (Navegar) para visitar por 
ejempio el Proyecto Gutenberg y descargar un libro a nuestro gusto. Lo 
importante es descargarlo en formato Zip porque Browse no puede 
descargar texto piano al Journal. Browse descarga el zip y lo abre conno 
si fuera un sitio web para verlo. El archivo zip aparecera como 
descargado en el Diario. 

No vamos a poder abrir el archivo desde el Diario con doble die porque 
nuestra programa no creo la entrada y hay muchas Actividades que 
soportan el tipo MIME zip. Para abrirlo necesitamos usar la opcion Start 
with (empezar con) del menu de opciones como se ve aca: 




Esto es lo que vemos cuando abrimos la entrada del Diario. 
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Produced by Anonymous Volurteers 



PRIDE AND PREJUDICE 
By Jane Austen 



Chapter 1 



It is a truth universally acknowledged, that a single man in possession 
of a good fortune, must be in want of a wife. 

However little known the feelings or views of sucli a man may be on his 

first entering a neighbojrhood, this trutli is so well fixed in the minds 



Tecnicamente esta es la primer iteracion de nuestra Actividad. Iteracion 
es una palabra muy utilizada que basicamente refiere a cosas que se 
hacen mas de una vez. En este libro hemos construido una Actividad 
liaciendo un paso a la vez para mostrar los conceptos basicos para 
escribir Actividades, pero escribir un programa en partes, testearlas, 
obtener feedback y entonces seguir escribiendo es una forma muy 
productiva de crear software (al usar la palabra iteracion el asunto 
suena bastante mas formal de como es de verdad). 

Aunque tu Actividad ya sea lo suficientemente buena como para que se 
la muestres a tu familia y amigos, debemos mejoraria antes un poco 
mas para publicaria por ahi. Como refinar tu Actividad es lo que 
veremos a continuacion. 



1. Traducido Ana Cichero, Uruguay- 
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J. U • Agregar detalles 

Barras de herramientas 

Que una Actividad necesita buenas barras de herramientas para ser de 
primera linea es una verdad universal. En este capitulo aprenderemos a 
liacerlas. Vamos a guardar las clases de las Toolbars en archivos 
separados del resto por si queremos que nuestra Actividad soporte tanto 
el estilo viejo como el nuevo. Si tenemos las clases correspondientes a 
las toolbars en dos archivos distintos el codigo puede decidir que archivo 
utilizar cuando se ejecuta. Por ahora este codigo soporta el estilo viejo 
que funciona en todas las versiones de Sugar. El estilo nuevo solo se 
utiliza hasta ahora en Sugar on a Stick (SoAS). 

Existe un archivo llamado toolbar. py en el fichero Add_Refinements 

del repositorio Git que se ve asi: 

from gettext import gettext as _ 
import re 

import pango 
import gobject 
import gtk 

from sugar . graphics . toolbutton import ToolButton 
from sugar . activity import activity 

class ReadToolbar(gtk .Toolbar ) : 

gtype_name = ' ReadToolbar ' 

def init (self): 

gtk. Toolbar . init (self) 

self. back = ToolButton( ' go-previous ' ) 
self . back. set_tooltip(_( ' Back ' ) ) 
self . back. props . sensitive = False 
self .insert(self . back, -1) 
self. back. show( ) 

self. forward = ToolButton( ' go-next ' ) 
self. for ward. set_tooltip(_( ' Forward ' ) ) 
self .forward . props . sensitive = False 
self .insert(self . forward, -1) 
self .forward . show( ) 

num_page_item = gtk .ToolItem( ) 

self . num_page_entry = gtk.Entry() 
self. num_page_entry . set_text ( ' ' ) 
self. num_page_entry . set_alignment(l) 
self. num_page_entry . connect( 'insert-text' , 
self . num_page_entry_insert_text_cb) 
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self . num_page_entry . set_width_chars(4) 

num_page_item. add ( self . num_page_entry) 
self . num_page_entry . show( ) 

self . insert (num_page_item, -1) 
num_page_item . show( ) 

total_page_item = gtk .ToolItem( ) 

self . total_page_label = gtk.Label() 

label_attributes = pango . AttrList ( ) 
label_at tributes .insert(pango.AttrSize( 

14000, 0, -1)) 
label_at tributes .insert(pango.AttrForeground( 

65535, 65535, 65535, 0, -1)) 
self . total_page_label. set_attributes( 

label_at tributes) 

self . total_page_label. set_text ( ' / 0') 
total_page_item. add ( self . total_page_label) 
self . total_page_label. show( ) 

self . insert (total_page_item, -1) 
total_page_item. show( ) 

def num_page_entry_insert_text_cb(self , entry, text, 
length, position) : 
if not re.match( ' [0-9] ' , text): 

entry .emit_s to p_by_name( 'insert-text' ) 

return True 
return False 

def update_nav_buttons(self ) : 

current_page = self . current_page 

self . back. props . sensitive = current_page > 

self .forward . props . sensitive = \ 

current_page < self . total_pages - 1 

self . num_page_entry. props . text = str( 

current_page + 1) 
self . total_page_label. props . label = \ 
/ ' + str(self . total_pages) 



' / ' 



def set_total_pages(self , pages): 
self . total_pages = pages 

def set_current_page(self , page): 
self .current_page = page 
self. update_nav_buttons( ) 

class ViewToolbar (gtk .Toolbar) : 

gtype_name = 'ViewToolbar' 

gsignals = { 

' needs-update-size' : (gobject .SIGNAL_RUN_FIRST, 

gobject .TYPE_NONE, 
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([])), 

'go-fullscreen' : (gobject .SIGNAL_RUN_FIRST, 
gobject .TYPE_NONE, 
([])) 



def init (self): 

gtk. Toolbar . init (self) 

self . zoom_out = ToolButton( ' zoom-out ' ) 
self. zoom_out .set_tooltip(_('Zoom out')) 
self . insert(self . zoom_out, -1) 
self. zoom_out . show( ) 

self . zoom_in = ToolButton( ' zoom-in ' ) 
self. zoom_in . set_tooltip(_( 'Zoom in ' ) ) 
self .insert(self . zoom_in, -1) 
self. zoom_in . show( ) 

spacer = gtk.SeparatorToolItem( ) 
spacer . props .draw = False 
self . insert(spacer, -1) 
spacer . show( ) 

self .fullscreen = ToolButton( ' view-fullscreen ' ) 
self. fullscreen. set_tooltip(_( 'Fullscreen' )) 
self. fullscreen. connect ( 'clicked' , 

self . f ullscreen_cb) 
self . insert(self . fullscreen, -1) 
self. fullscreen. show() 

def f ullscreen_cb(self , button): 
self. emit ( 'go-fullscreen' ) 

Otro archivo en el mismo fichero del repositorio Git se llama 
ReadEtextsActivity2.py. Se ve algo asi: 

import OS 

import zipfile 

import gtk 

import pango 

from sugar . activity import activity 

from sugar . graphics import style 

from toolbar import ReadToolbar, ViewToolbar 

from gettext import gettext as _ 

page=0 

PAGE_SIZE = 45 
TOOLBAR_READ = 2 

class ReadEtextsActivity(activity .Activity) : 

def init (self, handle): 

"The entry point to the Activity" 

global page 

activity .Activity . init (self, handle) 

toolbox = activity .ActivityToolbox(self) 
activity_toolbar = toolbox. get_activity_toolbar( ) 
activity_toolbar . keep . props .visible = False 
activity_toolbar . share . props .visible = False 
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self .eclit_toolbar = activity . EditToolbar( ) 
self .edit_toolbar . undo . props .visible = False 
self .edit_toolbar . redo . props .visible = False 
self .edit_toolbar . separator . props .visible = False 
self . edit_toolbar .copy. set_sensitive( False) 
self . edit_toolbar .copy.connect( 'clicked', 

self . edit_toolbar_copy_cb) 
self . edit_toolbar . paste . props .visible = False 
toolbox. ad d_toolbar(_( 'Edit'), self. edit_toolbar) 
self .edit_toolbar . show( ) 

self . read_toolbar = ReadToolbar( ) 

toolbox. add_toolbar(_( ' Read ' ) , self . read_toolbar ) 

self . read_toolbar .back.connect( 'clicked', 

self . go_back_cb) 
self . read_toolbar .forward.connect( 'clicked' , 

self . go_f orward_cb) 
self. read_toolbar . num_page_entry . connect ( ' activate ' , 

self . num_page_entry_activate_cb) 
self . read_toolbar . show( ) 

self . view_toolbar = ViewToolbar( ) 

toolbox. add_toolbar(_( 'View' ), self . view_toolbar ) 

self . view_toolbar . connect ( 'go-fullscreen' , 

self . view_toolbar_go_f ullscreen_cb) 
self . view_toolbar . zoom_in . connect ( ' clicked ' , 

self . zoom_in_cb) 
self . view_toolbar . zoom_out . connect( ' clicked ' , 

self . zoom_out_cb) 
self . view_toolbar . show( ) 

self . set_toolbox( toolbox) 

toolbox. show( ) 

self . scrolled_window = gtk .ScrolledWindow( ) 

self . scrolled_window. set_policy(gtk . POLICY_NEVER, 

gtk.POLICY_AUTOMATIC) 
self . scrolled_window. props . shadow_type = \ 

gtk.SHADOW_NONE 

self . textview = gtk .TextView( ) 
self.textview. set_editable( False) 
self. textview. set_cur so r_visible( False) 
self. textview. set_lef t_margin(50) 
self. textview. connect( "key_press_event", 
self . keypress_cb) 

self . scrolled_window. add (self. textview) 

self . set_canvas(self . scrolled_window) 

self. textview. show() 

self . scrolled_window. show( ) 

page = 

self .clipboard = gtk.Clipboard( 

display=gtk . gdk . display_get_default ( ) , 

selection= "CLIPBOARD") 
self. textview. grab_focus( ) 
self .font_desc = pango . FontDescription( "sans %d" % 

style. zoom(10) ) 
self . textview. modif y_f on t (self . font_desc) 
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buffer = self . textview. get_buffer( ) 

self .markset_id = buffer . connect( "mark-set", 

self .mark_set_cb) 
self .toolbox. set_curr en t_toolbar( TOO LBAR_READ) 

def keypress_cb(self , widget, event): 

"Respond when the user presses one of the arrow keys" 

keyname = gtk . gdk . keyval_name(event . keyval) 

print keyname 

if keyname == 'plus': 

self . f ont_increase( ) 

return True 
if keyname == 'minus': 

self . f ont_decrease( ) 

return True 
if keyname == 'Page_Up' : 

self . page_previous( ) 

return True 
if keyname == 'Page_Down': 

self . page_next( ) 

return True 
if keyname == 'Up' or keyname == 'KP_Up' \ 
or keyname == 'KP_Left': 

self . scroll_up( ) 

return True 
if keyname == 'Down' or keyname == ' KP_Down ' \ 
or keyname == 'KP_Right': 

self . scroll_down( ) 

return True 
return False 

def num_page_entry_activate_cb(self , entry): 
global page 
if entry . props . text : 

new_page = int(entry. props . text) - 1 
else: 

new_page = 

if new_page >= self . read_toolbar . total_pages : 

new_page = self . read_toolbar . total_pages - 1 

elif new_page < 0: 
new_page = 

self . read_toolbar . current_page = new_page 

self. read_toolbar . set_current_page(new_page) 

self. show_page(new_page) 

entry . props . text = str(new_page + 1) 

self. read_toolbar . update_nav_buttons( ) 

page = new_page 

def go_back_cb(self , button): 
self. page_previous( ) 

def go_forward_cb(self , button): 
self. page_next ( ) 

def page_previous(self ) : 
global page 
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page=page-l 

if page < 0: page=0 

self . read_toolbar . set_current_page(page) 

self . show_page(page) 

v_acljustinent = \ 

self . scrolled_window. get_vadjustment( ) 
v_adjustment .value = v_adjustment . upper -\ 

v_ad just men t . page_size 

def page_next (self ) : 
global page 
page=page+l 

if page >= len(self . page_index) : page=0 
self . read_toolbar . set_current_page(page) 
self. show_page(page) 
v_adjustment = \ 

self . scrolled_window. get_vadjustment( ) 
v_adjustment . value = v_adjustment . lower 

def zoom_in_cb(self , button): 
self . font_increase( ) 

def zoom_out_cb(self , button): 
self . font_decrease( ) 

def font_decrease(self ) : 

font_size = self . f ont_desc . get_size( ) / 1024 
font_size = font_size - 1 
if font_size < 1: 
font_size = 1 
self .font_desc. set_size(font_size * 1024) 
self . textview.modify_font (self . font_desc) 

def font_increase(self ) : 

font_size = self . f ont_desc .get_size( ) / 1024 
font_size = font_size + 1 
self .font_desc. set_size(font_size * 1024) 
self . textview.modify_font (self . font_desc) 

def mark_set_cb(self , textbuffer, iter, textmark): 

if textbuffer. get_has_selection( ) : 

begin, end = textbuffer . get_selection_bounds( ) 
self . edit_toolbar .copy. set _sensitive(True) 

else : 

self . edit_toolbar .copy. set _sensitive(False) 

def edit_toolbar_copy_cb(self , button): 

textbuffer = self . textview. get_buffer( ) 
begin, end = textbuffer . get_selection_bounds( ) 
copy_text = textbuffer . get_text(begin, end) 
self. clipboard. set_text(copy_text ) 

def view_toolbar_go_f ullscreen_cb(self , view_toolbar ) : 
self.fullscreen() 

def scroll_down(self ) : 
v_adjustment = \ 

self. scrolled_window. get_vadjustment( ) 
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if v_adjustment . value == v_adjustment . upper - \ 
v_adjustment . page_size : 
self . page_next( ) 
return 
if v_adjustment .value < v_adjustment . upper - \ 
v_adjustment . page_size : 
new_value = v_adjustment .value + \ 

v_adjustment . step_increment 
if new_value > v_adjustment . upper - \ 
v_adjustment . page_size : 
new_value = v_adjustment . upper - \ 
v_adjustment . page_size 
v_adjustment .value = new_value 

def scroll_up(self ) : 
v_adjustment = \ 

self . scrolled_window. get_vad just men t( ) 
if v_adjustment . value == v_adjustment . lower : 
self . page_previous( ) 
return 
if v_adjustment .value > v_adjustment . lower : 
new_value = v_adjustment .value - \ 

v_adjustment . step_increment 
if new_value < v_adjustment . lower : 
new_value = v_adjustment .lower 
v_adjustment .value = new_value 

def show_page(self , page_number) : 

global PAGE_SIZE, current_word 

position = self . page_index[page_number] 

self .etext_file. seek(position) 

linecount = 

label_text = '\n\n\n' 

textbuffer = self . textview. get_buffer( ) 

while linecount < PAGE_SIZE: 

line = self .etext_file. readline( ) 
label_text = label_text + unicode(line, 

'iso-8859-1' ) 
linecount = linecount + 1 

label_text = label_text + '\n\n\n' 

textbuffer. set_text(label_text) 

self. textview. set_buffer(textbuffer) 

def save_extracted_f ile(self , zipfile, filename): 

"Extract the file to a temp directory for viewing" 
filebytes = zipfile . read(filename) 
outfn = self .make_new_filename(f ilename) 
if (outfn == ' ' ) : 

return False 
f = open(os . path . join(self . get_activity_root ( ) , 

'tmp', outfn), 'w') 
try: 

f.write(file bytes) 
finally: 

f . close( ) 

def get_saved_page_number(self ) : 
global page 
title = self .metadata. get('title' , '') 
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if title == '' or not title[len(title) - 1] .isdigit ( ) 

page = 
else : 

i = len(title) - 1 

newPage = ' ' 

while (title[i] . isdigit( ) and i > 0) : 

newPage = title[i] + newPage 

i = i - 1 
if title[i] == 'P' : 

page = int(newPage) - 1 
else : 

# not a page number; maybe a volume number. 

page = 

def save_page_number(self ) : 
global page 

title = self .metadata. get( 'title' , '') 
if title == '' or not title[len(title) -1] . isdigit() : 

title = title + ' p' + str(page + 1) 
else : 

i = len(title) - 1 

while (title[i] . isdigitO and i > 0) : 

i = i - 1 
if title[i] == 'P' : 

title = title[0:i] + 'P' + str(page + 1) 
else : 

title = title + ' p' + str(page + 1) 
self .metadata[ 'title'] = title 

def read_file(self , filename): 
"Read the Etext file" 
global PAGE_SIZE, page 

if zipfile . is_zipf ile(filename) : 

self.zf = zipfile .ZipFile(filename, 'r') 
self . book_f iles = self .zf . namelist( ) 
self . save_extracted_file(self . zf , 

self .book_f iles [0] ) 
currentFileName = os . path . join( 
self. get_activity_root ( ) , 
'tmp', self . book_files[0] ) 
else : 

currentFileName = filename 

self .etext_file = open(currentFileName, "r" ) 

self . page_index = [ ] 

pagecount = 

linecount = 

while self . etext_f ile : 

line = self .etext_file . readline( ) 
if not line: 

break 
linecount = linecount + 1 
if linecount >= PAGE_SIZE: 

position = self .etext_file. tell( ) 
self. page_index. append (posit ion) 
linecount = 
pagecount = pagecount + 1 
if filename . endswith( ". zip" ) : 
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os.remove(currentFileName) 
self. get_saved_page_number( ) 
self. show_page(page) 

self . read_toolbar . set_total_pages(pagecount + 1) 
self. read_toolbar . set_current_page(page) 

def make_new_f ilename(self , filename): 

partition_tuple = filename. rpartition( '/' ) 
return partition_tuple[2] 

def write_file(self , filename): 

"Save meta data for the file." 

self .metadata[ ' activity ' ] = self .get_bundle_id( ) 

self. save_page_number( ) 

Este es el activity.info para este ejemplo: 

[Activity] 

name = Read ETexts II 

service_name = net .flossmanuals . ReadEtextsActivity 

icon = read-etexts 

exec = sugar-activity ReadEtextsActivity2. ReadEtextsActivity 

show_launcher = no 

activity_version = 1 

mime_types = text/plain;application/zip 

license = GPLv2+ 

La linea en negrita es la unica que necesita cambiarse. Cuando 
corramos esta nueva version esto es lo que veremos: 




Prodjced by Anonymojs Volunteers 



PRIDE AMD PREJUDICE 
By Jane Austen 



Chapter 1 



It is a truth universally acknowledged, that a single nnan in possession 
of a good fortune, must be in want of a wife. 

However little known the feelings or views of such a man may be on his 
first entering a neighbourhood, this truth is so well fixed in the minds 



Hay varias cosas que vale la pena senalar en este codigo. Miremos 
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primero este import: 

from gettext import gettext as _ 

Usaremos el modulo Python gettext para que nuestra Actividad soporte 
traducciones a otras lenguas. Lo usaremos en sentencias como esta: 

self. back. set_tooltip(_( ' Back ' ) ) 

Por la forma en la que importamos gettext, el guion bajo actuara como 
esta funcion. El efecto de esta sentencia sera buscar en los archivos 
especiales de traducciones la palabra o frase que concuerde con la clave 
"Back" y la remplace por su traduccion. Si no hubiera archivo de 
traduccion para el lenguaje deseado simplemente usara la palabra 
"Back". Mas adelante exploraremos como armar estos archivos de 
traduccion, por ahora es suficiente con asegurarnos de usar gettext para 
todas las palabras o frases que vayamos a mostrar al usuario de nuestra 
Actividad. 

La segunda cosa que vale la pena destacar es que mientras nuestra 
Actividad tiene cuatro barras de herramientas, solo tuvimos que crear 
dos de ellas. Las barras Activity y Edit son parte de la libreria Sugar de 
Python. Podemos usar esas toolbars como estan, esconder controles que 
no queremos o tambien ampliar estas barras agregando controles 
nuevos. En este ejempio estamos escondiendo los controles Keep 
(Guardar) y Sliare (Compartir) de la barra Activity y Undo (Deshacer), 
Redo (Rehacer), and Paste (Pegar) de de la barra Edit. Estos controles 
no son necesarios actualmente en tanto no hay soporte para compartir 
modificar libros. Observen tambien que Activity toolbar es parte de 
ActivityToolbox. No hay forma de darle a la Actividad una toolbox que no 
contenga a la Activity toolbar como primera opcion. 

Otra cosa para sehalar es que la clase Actividad no solo nos provee con 
una ventana. La ventana tiene una Vbox para contener nuestras barras 
de herramientas y el cuerpo de nuestra Actividad. Instalaremos el 
toolbox usando set_toolbox() y el cuerpo de la Actividad utilizando 
setcanvasO. 

Las barras Read y View son codigo PyGtk comun pero tienen un boton 
especial para las barras de Sugar que pueden tener un tooltip asociado, 
y ademas la barra View tiene codigo que nos permite ocultaria y la 
barra ReadEtextsActivity2 tiene codigo para des-ocultarla. Esta es una 
funcion facil de agregar a tus propias Actividades y muchos juegos y otro 
tipo de Actividades pueden beneficiarse con la mayor area de pantalla 
que se obtiene cuando ocultamos la barra. 
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Metadata y entradas al Journal. 

Cada entrada del Diario representa un unico archive y su metadata 
(informacion que describe al archive). Hay entradas estandar de 
metadata que estaran en cualquier entrada al Diario pero tambien 
puedes crear metadata a tu criterio. 

A diferencia de ReadEtextsActivity, esta version que analizaremos tiene 
un metodo write JileQ 

def write_file(self , filename): 

"Save meta data for the file." 

self .metadata[ ' activity ' ] = self .get_bundle_id( ) 

self. save_page_number( ) 

No teniamos un metodo write_file () antes porque no necesitabamos 
escribir en el archivo que contiene al libro. Sin embargo, para la 
actualizacion de los metadatos de la entrada del Diario lo vamos a usar. 
En concreto, vamos a estar haciendo dos cosas: 

• Guardar el numero de pagina donde el usuario de nuestra Actividad 
suspendio la lectura para que pueda retomaria cuando vuelva a 
lanzar la Actividad. 

• Decirle al Jounal que esa entrada pertenece a nuestra Actividad, de 
modo que en el futuro directamente use el icono apropiado y lance 
la actividad al hacer die en la entrada. 

Para que la Actividad Read guarde el numero de pagina usamos una 
propiedad personalizada de la metadata: 

self .metadata[ ' Read_current_page ' ] = \ 

str(self._document. get_page_cache( ) . get_current_page( ) ) 

Para almacenar el numero de pagina actual. Read crea una propiedad 
de metadata llamada Read_current_page. Es tan facil crear metadata 
customizada (personalizada) que algunos podran preguntarse porque 
no usamos esto para Read Etexts. De hecho en la primer version de 
Read Etexts usaba una propiedad customizada, pero en Sugar 0.82 y 
anteriores habia un bug y los metadatos asi guardados no sobrevivian al 
apagado de la computadora. Esto resultaba en que la actividad podia 
recordar numeros de paginas solamente mientras el equipo estuviera 
funcionando. Actualmente hay algunas laptops XO que no pueden 
actualizarse a nada mas nuevo que .82 y otras que aunque puedan no se 
actualizan porque esto implica un enorme trabajo para las escuelas. 

Para esquivar este problema escribi este par de metodos: 

def get_saved_page_number (self ) : 
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global page 

title = self .metadata. get( 'title' , '') 

if title == '' or not title[len(title) -1] . isdigit( ) : 

page = 
else : 

i = len(title) - 1 
newPage = ' ' 

while (title[i] . isdigit( ) and i > 0) : 
newPage = title[i] + newPage 
i = i - 1 
if title[i] == 'P' : 

page = int(newPage) - 1 
else : 

# not a page number; maybe a volume number, 
page = 

def save_page_number(self ) : 
global page 

title = self .metadata. get( 'title' , '') 
if title == '' or not title[len(title) -1] . isdigit( ) : 

title = title + ' p' + str(page + 1) 
else : 

i = len(title) - 1 

while (title[i] . isdigitO and i > 0): 

i = i - 1 
if title[i] == 'P' : 

title = title[0:i] + 'P' + str(page + 1) 
else : 

title = title + ' p' + str(page + 1) 
self .metadata[ 'title'] = title 

save_page_number () usa la metadata del titulo actual y, o bien anade el 
numero de pagina al final del titulo o actualiza el numero de pagina que 
ya esta ahi. Como title (titulo) es parte de la metadata estandar de toda 
entrada al Journal, el bug no afecta este metodo. 

Estos ejemplos tambien muestran como leer la metadata. 

title = self .metadata. get( 'title' , '') 

Esta linea de codigo dice: "Obtener la propiedad de metadata llamada 
title y poneria en la variable llamada title, si no existiera una propiedad 
title poner una cadena vacia en title. 

Normalmente se guardara metadata en el write_file () y se leera en el 
metodo readJUe (). 

En una Actividad corriente de las que crean algun tipo de archivo con 
write_file() esta linea seria innecesaria: 

self .metadata[ ' activity ' ] = self . get_bundle_id( ) 
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Cualquier entrada al Diario creada por otra Actividad tendra 
automaticamente seteada esta propiedad. En el caso de Pride and 
Prejudice nuestra Actividad no creo la entrada. Read Etexts puede leerla 
porque nuestra Actividad soporta su tipo MIME. Desafortunadamente, 
este tipo de MIME, application/zip, es utilizado por muchas Actividades. 
Me resulto muy frustrante querer abrir un libro en Read Etexts y abrirlo 
sin querer en EToys. Esta linea de codigo resuelve este problema. Tu 
solamente precisas usar Start Using... (Empezar a usar) la primera vez 
que leas un e-book. Despues de ello, el libro usara el icono de Read 
Etexts y puede retomarse con un simple die. 

Esto no afecta para nada el tipo MIME de la entrada en el Diario, asi que 
si quieres abrir Pride and Prejudice con Etoys, todavia es posible. 

Antes de dejar el tema de la metadata del Journal echemos un vistazo a 
la metadata estandar que toda Actividad tiene. Aqui vemos un codigo 
que crea una entrada al Diario y actualiza unas cuantas de las 
propiedades estandar. 
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Este codigo fue tornado de una Actividad que escribi y que descarga los 
e-books desde la web y crea para ellos entradas al Diario. Las entradas al 
diario contienen un titulo amigable y una descripcion completa de cada 
libro. 

Aunque la mayoria de las Actividades manejan al Diario exclusivamente 
con los metodos read_file() y write_file(), no hay por que limitarse a esto. 
En un capitulo posterior voy a mostrar conno crear y elinninar entradas al 
Journal, como listar su contenido y mucho mas. 

En este capitulo tratamos una gran cantidad de informacion tecnica y 
hay mas por venir, pero antes de llegar a ella tenemos que ver algunos 
temas importantes: 

• Subir tu Actividad a un controlador de versiones. Esto te permite 
compartir tu codigo con el mundo entero y quizas lograr que otras 
personas decidan trabajar sobre el. 

• Tener tu Actividad traducida a otros idiomas. 

• Distribuir tu Actividad ya terminada. (O tu Actividad casi-terminada, 
pero util igual). 



1. Traducido Ana Cichero, Uruguay- 
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J. J. • Anadir tus fuentes al control de 
versiones 

^Que es el control de versiones? 

"Si he visto mas lejos es solo por estar parado sobre los hombros 
de gigantes." 

Isaac Newton, en una carta a Robert Hooke. 

Escribir una Actividad es algo que nornnalnnente no harias solo. 
Habitualmente tendras colaboradores de una manera u otra. Cuando 
empece a escribir Read Etexts (Leer Etextos) copie bastante del codigo 
de la Actividad Leer (Read). Cuando implemente la lectura sintetizada de 
texto, adapte una barra de herramientas de la Actividad Hablar (Speak). 
Cuando finalmente consegui hacer funcionar la caracteristica de 
compartir archivos, el autor de Image Viewer penso que estaba buena 
para incorporaria a esa Actividad. Otro programador vio el trabajo que 
hice para la lectura sintetizada y penso que podria hacerlo mejor. Tenia 
razon, y sus mejoras fueron combinadas con mi codigo. Cuando escribi 
Get Internet Archive Books alguien mas tomo la interfaz que hice y 
realizo una Actividad mas potente y versatil llamada Get Books. Al igual 
que Newton, todos se benefician del trabajo que los demas han hecho 
antes. 

Aunque quisiera escribir Actividades sin ayuda, necesitaria 
colaboradores para traducirlas a otros idiomas. 

Para posibilitar la colaboracion necesitas tener un lugar donde todos 
puedan colocar sus fuentes y compartirlas. Este lugar se llama 
repositorio de codigo. No es suficiente con compartir la ultima version de 
tu codigo. Lo que realmente quieres es compartir todas las versiones de 
tu codigo. Cada vez que hagas un cambio significativo a tu codigo 
querras tener la nueva version y la anterior disponibles. No solo querras 
tener todas las versiones de tu codigo disponibles sino que querras ser 
capaz de comparar cualquier par de versiones entre si para ver que 
cambio entre ellas. Esto es lo que hace el software de control de 
versiones. 

Las tres herramientas de control de versiones mas populares son CVS, 
Subversion y Git. Git es la mas nueva y la que se usa en Sugar Labs. Si 
bien no todas las Actividades tienen su codigo en el repositorio Git de 
Sugar Labs (existen otros), no hay buenas razones para no hacerlo y si 
tiene bastantes ventajas. Si quieres que tu Actividad sea traducida a 
otras lenguas, tendras que usar el repositorio Git de Sugar Labs. 
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GitJ^ 

Git es un sistema de control de versiones distribuido. Esto quiere decir 
que hay copias de cada version de tu codigo fuente en un repositorio 
central y ademas las mismas copias existen en la computadora de cada 
usuario. Esto significa que puedes actualizar tu repositorio local estando 
desconectado, y luego al estar conectado a la Internet, compartir todo de 
una vez. 

Hay dos formas para interactuar con un repositorio Git: a traves de 
comandos Git y a traves del sitio web en http://git.sugarlabs.org/. 
Veamos primero el sitio web 

Dirigete a http://git.sugarlabs.org/ y haz die sobre el enlace Projects 
(Proyectos) en la parte superior derecha: 



Projects Search About Rgglster Login 



sugarlabs 



Encontraras una lista de proyectos en el repositorio. Estaran ordenados 
del mas reciente al mas antiguo. Tambien encontraras el enlace New 
Project (Nuevo Proyecto), pero necesitaras abrir una cuenta para hacer 
eso y no estamos listos, todavia. 
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New project 



karma_English_Alphabet_Puzzle_Solving 

A simple English Alpinalaet lesson 
Categories: none 



karma_Conozco-Uruguay 

A simpie iesson for learning the geography of Unjguay 
Categories: none 



karma_adding_up_to_1 0_svg 

A simpie game for iearning horn to add up to 1 
Categories: none 



supervisor 

A privileged service which supervises activity run cycle, exposes startup prcgress, upgr 

infrastnjcture, 

Categories: service 

Si eliges la opcion Search (Buscar) en la esquina superior derecha de la 
pagina obtendras un formulario de busqueda. Usalo para buscar "read 
etexts". Elige ese proyecto cuando lo encuentres. Deberias ver algo asi: 
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readetexts 

Read Etexts is an alternative to the regular Read Activity wtiicti can read Project Gutenberg pla 
stopgap until Read itself can use ttiis tormat. Plain text tiles are tjy tar ttie most popular Gutent 
thousands ot tree t^ooks in many languages, 

In addition to the normal ebook reader functions this reader adds text to speech with karaoke st 
needs speech-dispatcher installed, which is not currently part of the Sugar distribution but even 



Activities 



FRIDAY MARCH 1 


3 






□1:50 


LL 


alsroot deleted 


repository readetexts/gst-plugins 


espeak 


SATURDAY 


r.lARC 


H07 






17:58 


[L 


alsroot deleted 


repository readetexts/bugfix 




FRIDAY FEBRUARY 27 



22:49 |£ jdslmmons added committer pootle to readetexts/mainline 

Esta pagina lista algunas de las actividades para el proyecto pero yo no 
la encuentro particularmente util. Para dar un mejor vistazo a tu 
proyecto inicia haciendo die en el nombre del repositorio al lado derecho 
de la pagina. En este caso, el nombre del repositorio es mainline. 



i^beis: activities 

License: GNU General Public License version 2fGPLv2) 

Owner: jdslmmons 

Created: 1g Jan 00:38 



Repositories 

^ mainline 

[^ jc^immons 



Veras algo parecido a esto en la parte superior de la pagina: 
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"mainline" repository in readetexts 



Public clone uri: git; //git, sugarlabs .org/readetejcts/rrBinline, git moi^ info... 

You can clone this repository with the fbiiowing corTimand: 

git clone git: //git .sugarlabs, org/readetexts/mainline. git 

HTTP clone urI: http : //git.sjgarlabs . □rg/git/readetexts/rrainline.git r«V3rB info.. 

You can cione this repository with the foiiowing command: 

git clone http://git.sugarlabs.org/git/readetexts/mainline.git 

[nMeirra] cbnir^ over HTTP b algmf^akMsr. bul LBeful f yoL/reb©riindaFirBWHllJ 



Activities 



SUN DAY JANUARY IS 



23:04 [i jdsimmons committed 7ea8697a to readeteKts/mainiine 
modified: ReadEtextsActivity.py 

Esta pagina contiene informaciomn util. Primero, echa un vistazo a la 
Public clone urI [UrI publica para clonacion] y la HTTP clone urI [UrI 
para clonacion HTTP]. Necesitas hacer die en More info (JVjas info) para 
ver cualquiera de las dos. Si ejecutas cualquiera de estos comandos 
desde la consola, obtendras una copia del repositorio git del proyecto en 
tu computador. Esta copia incluira cada version de cada fragmento de 
codigo en el proyecto. Vas a tener que modificarlo un poco antes de 
compartir tus cambios de vuelta en el repositorio principal, pero todo 
estara ahi. 

La lista bajo Activities (Actividades) no es tan util, pero si haces die en 
Source Tree (Arbol de fuentes) veras algo realmente bueno: 
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Tree of mainline repository in readetexts 

t mainline 



G .gitignore 


01 Sep 23:16 


modified: 


.gitignore modified; HAN: 


1^ activity/ 


22 Ntw 30:52 


modified : 


ReadEteKtsActiuity . py moi 


D ausextract.py 


aOMay 21:E2 


modified : 


ReadEtextsActiuity . py moi 


G gutextract.py 


30 May 21:52 


modified; 


ReadEtentsActiuity .py moi 


G heip.txt 


22N(WS0:52 


modified; 


ReadEtextsActivity .py moi 


C3 locale' 


06Dec23:S 


new file; 


locale/it05/LC_MESSAGES/o 


G MANiFEST 


22 Nov 23:31 


modified; 


MANIFEST modified; locali 


G NEWS 


01 Mar 33:48 


Initial import 


G pgconvert.py 


29 Nm 22:34 


modified ; 


ReadEteKtsActivity . py moi 


^paS 


11 Nov 05:55 


Commit from Sugar Labs; Translatioi 


G ReadEtextsActivlty.py 


29 Nov 22:34 


modified; 


ReadEtextsActiuity .py moi 


G reads Id ebar.py 


25Jun4:48 


modified ; 


ReadEtextsActiuity . py moi 


G readtoolbar.py 


06Dec23:S 


new file; 


loi-ale/it05/LC_HESSAGES/o 



Q rtfconvert.py 22Nqv 23:26 modified: ReadEtextsActiuity .py moi 

Aqui hay una lista de cada archive en el proyecto, su ultima fecha de 
actualizacion, y un comentario sobre que fue modificado. Haz die en el 
enlace para ReadEtextsActivlty.py y veras esto: 
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Project Overview 


1 



Repositories 
Overview Commits Source Tree Comments (0) Merge requests(O) 



Blob of ReadEtextsActivity . py (raw blob data) 



/ mainline / ReadEtaxtsActivity.py 

#! /U5r/bin/en(/ pytlnon 



1 
2 
3 
4 
5 
6 
7 
B 

a 

10 

11 

12 
13 
14 
15 
16 
17 
IB 
19 
20 
£1 
22 
23 
24 
25 
26 
27 
28 



# Copyright (C) 2GD8, 20G9 James D. Sinrrans 
# 

# This program is f r"ee sofftjarej you can redistribute it and/or modify 

# it under the terms of the GNU General Public License as published by 

# the Fr"ee Soft»jare Foundation; either version 2 of the License, or 

# (at your option) any later version, 
# 

# This program is distributed in the hope that it will be useful, 

# but WITHOUT ANY WARRANTY; without even the irrplied warranty of 

# MERCHANTABILITY or FITTJESS FOR A PARHCULAR PURPOSE, See the 

# 5NU General Public License for more details, 
# 

# You should have received a copy of the GNU General Public License 

# along with this program; if not, write to the Free Software 

# Foundation, Inc, 51 Franklin St, Fifth Floor, Boston, MA Q2110-1301 
irrport os 

irtport logging 

iriport tenpfile 

irrport time 

irrport zipfile 

irrport pygtk 

pygtk. requirel '2.0' ) 

inr|)ort gtk 

irrport string 

from sugar, graphics im|:C'rt style 

from sugar irrport profile 



Este es el codigo mas reciente en ese archive en formato embellecido. 
Las palabras clave de Python se muestran en colores, tienen numeros de 
linea, etc. Esta es una buena pagina para mirar el codigo en la pantalla 
pero no queda bien al imprimirlo y no sirve mucho para copiar 
fragmentos de codigo en ventanas del editor Eric. Para hacer estas cosas 
querras hacer die en raw blob data (data sin procesar) en la parte 
superior del listado: 
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#! /usr/bin/ern; python 

# Copyright (C3 20D8, 2DG9 James D, Simmons 
# 

# This program is free software; you can redistribute it and/or modify 

# it under the terras of the GNU General Public License as published by 

# the Free Software Foundation; either version 2 of the License, or 

# (at your option) any later version, 
# 

# This program is distributed in the hope that it will be useful, 

# but WITHOUT ANY WARRANTY; without even the implied warranty of 

# MERCHANTABILITY or FITTJESS FOR A PARTICULAR PURPOSE. See the 

# GNU General Public License for more details. 
# 

# You should have received a copy of the GNU General Public License 

# along with this program; if not, write to the Free Software 

# Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, RA 02110- 13QI USA 
import OS 

import logging 

import terapfile 

import time 

import zipfile 

import pygtk 

pygtk. require! '2.0') 

import gtk 

import string 

from sugar. graphics import style 

from sugar import profile 

from sugar. activity import activity 

from sugar import network 

from sugar. datastore import datastore 

from sugar. oraohics. alert import NotifvAlert 

Aun no terminamos. Usa el boton Back (Atras) para regresar al listado 
embellecido y haz die en el enlace que dice Commits (Consignaciones). 
Este arrojara un listado de todo lo que ha cambiado cada vez que hemos 
consignado codigo en Git. 
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readetexts 


^B M 


1 ^^^^^^^1 




Overview Commits 


Source Tree Comments (0) 


Merge requestB(O) 



Commitlog for mainline:master in readetexts 



SUNDAY DECEMBER 05 



23:39 IX J arnes Simmons committed CC812Q3 

new file: locale/kos/LC_MESSAGES/org. laptop. sugar .ReadEtextsActivit^.mo 



22:34 X 'Barnes Simmons committed 720affc 
modified: ReadEtextsActivity.py 



23:31 S James Simmons committed 35bf41 7 
modified: MANIFEST 

23:26 |£ James Simmons committed clcS322a 
modified: ReadEtextsActivity.py 

20:52 X J arnss Simmons committed f9cd855 
modified: ReadEtextsActivity. py 

Habras notado una combinacion extrana de letras y numeros despues de 
las palabras James Simmons committed [James Simmons consigno]. 
Esto es un tipo de numero de version. La practica habitual en sistemas 
de control de versiones es darle a cada version de codigo ingresada al 
sistema un numero de version, habitualmente uno consecutivo. Git es 
distribuido, con varias copias separadas del repositorio que pueden ser 
modificadas independientemente y luego combinadas. Esto hace 
imposible usar un numero secuencial para identificar las versiones. En 
cambio, Git le da a cada version un numero aleatorio realmente grande. 
Este numero se expresa en base 16, usando los simbolos 0-9 y a-f. Lo 
que ves en verde es tan solo una parte pequena del numero completo. El 
numero es un enlace, y si haces die en el veras esto: 



81 



Commit cc81 2030cbf3ec8a51 4275fb97c2ca425b21 6a2f 



Date: Sun Dec 06 23;39;56+D()00 2009 

Committer: James Simmons (jim@simmons.olpc) 

Author: James Simmons (jlm@simmons.oipc) 

Commit SHA1: Cc812030cl3f3ec8a514275fb97ca;a425b21 6a2f 

Tree SHA1: aaOf8aadc7e36b9e75047a8a;S34lDif234c993a65 



new file: locale/i<05/LC HESSAGES/org . laptop . sugar. ReadEtextsActivity. mo 

new file: locale/l^os/acTivit^.linfo 

new file: locale/tzo/LC MESSAGES/org . laptop . sugar. ReadEtextsActiuity. mo 

new file: locale/tzo/acTivlty.linfo 

modified: readtoolbar.py 

fflodify speech toolbar to save and restore speech settings, 



Commit diff 



Comments (0) 



readtOOlbar. py 29 --++4-4-4-++4-4-4-4-+4-4-4-4-+4-4-4-4-+4-4-4-4-+ 

locale/tzo/activity.linfo 2 ++ 

locale/tzo/LC_MESSAGES/org . laptop .sugar, ReadEtextsActivity , mo 

locale/ kos/activity.linfo 2 ++ 

locale/ kos/LC_MESSAGES/org . laptop . suga r , ReadEtextsActivity , mo 

Commit diff 

locale/ko£/LC_MESSAGES/ora. laptop, sugar. ReadEtextsActivity. mo 

A! inicio de la pagina veremos el numero de version complete utilizado 
para esta consignacion. Debajo de la caja gris vemos Ids comentarios 
completes que fueron usados para consignar Ids cambios. Debajo de esto 
hay una lista de los archivos que fueron modificados. Si miramos mas 
abajo en la pagina, veremos esto: 
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readtoolbar.py 



15 

16 I 

17 

18 
19 j 

416 

417 j 

41B 

419 

428 

421 

422 



15 # along with this program; if notj write to the Free Software 

15 j# Foundation, Inc., 51 Franl^lin St, Fifth Floor, Boston, MA 02110-1301 

17 1 

IB 'Import 05 

19 import logging 

2B from gettext Import gettext as _ 

21 import re 



416 
417 
41B 

419 
420 

421 



comt)otool,show() 

self .pitchad] = gt k. Adjustment (B, -100, 100, 1, 10, 01 

self , pitchad] , connect ( "value_changed" , self , pitch_adjusted_cbfj 

pitchbar = gtl<.HScale(self .pitchad] ) 

pitchbar , set_draw_value( False) 

pitchbar, set_update_policy(gtK,UPDA"re_DISCONnrJUOUS) 



u 



427 427 
42B' 42B 



429 
430 

431 



429 



43Q! 
432^ 431 

433 432 

453 453 

454 454 
455 j 455 

456 



pitchbar, show!) 

5elf,rateadi = gtk,Ad]ustraent[0, -100, lOO, 1, 10, 0) 

self, rateadj . connect ("'i(alue_changed", self. rate_adjusted_cb) J 

ratebar = gtk, HScale[self , rateadj ) 

ratebar,set_draw_value[ False) 

ratebar,set_update_policy(gtk,UPDATi_DISCON TENUOUS) 



def pitch_adjusted_cb(self , get): 
speech, pitch = int (get, walue) 
speech , sa^(_( "pitch adjusted" ) ) 
f = open[os,path, joln(5elf .activity.get_activity_root (), 



'Insta 



Este es un reporte diff el cual muestra las lineas que han cambiado 
entre esta version y la anterior. Para cada cambio muestra algunas 
lineas antes y despues para dar una mejor idea de lo que el cambio 
hace. Cada cambio muestra tambien los numeros de linea. 

Un reporte como este es una gran ayuda para programar. Algunas 
veces, cuando estas trabajando en una mejora a tu programa, algo que 
ha estado funcionando, misteriosamente deja de hacerlo. Cuando esto 
pasa, te preguntaras que cambio habra causado el problema. Un reporte 
diff puede ayudarte a encontrar el origen del problema. 

A estas alturas estaras convencido de poner el codigo de tu proyecto en 
Git. Antes de poder hacer esto necesitamos crear una cuenta en este 
sitio web. No es mas dificil que en otros sitios, pero necesitamos 
informacion importante que todavia no tenemos. Obtener esta 
informacion sera nuestra proxima tarea. 
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Preparando las claves SSH 

Para enviar tu codigo al repositorio de Gitorious necesitas un par de 
claves publicas/privadas SSH. SSH es una manera de enviar datos a 
traves de la red en formato encriptado. (en otras palabras, utiliza un 
codigo secreto para que nadie mas que la persona que recibe los datos 
puede leerlos). El encriptamiento de claves publicas/privadas es una 
forma de encrirptar datos que provee de una forma de garantizar que la 
persona que esta enviando los datos es quien dice ser. 

En terminos simples, funciona asi: el software SSH genera dos numeros 
muy grandes que son usados para codificar y decodificar la informacion 
que transita por la red. El primer numero, llamado la clave privada, es 
mantenido en secreto y solo usado para codificar datos. El segundo 
numero, llamado clave publica, es dado a quien sea que necesite 
decodificar estos datos. Tambien es posible usar la clave publica para 
codificar un mensaje para ser enviado a ti y tu podras decodificarlo con 
tu clave privada. 

Git usa SSH como una firma electronica para verificar que los cambios 
de codigo que supuestamente son tuyos, de hecho lo sean. Le daremos 
tu clave publica al repositorio Git. Sabra entonces que cualquier cosa 
que pueda decodificar con esta clave habra sido enviada por ti, porque 
solo tu tienes la clave privada correspondiente para codificarlo. 

Estaremos usando una herramienta llamada OpenSSH para generar las 
claves publicas/privadas. Esta esta incluida con cada version de Linux asi 
que no necesitas verificar que haya sido instalada. Luego utiliza la 
utilidad ssh-keygen que viene con OpenSSH para generar las claves: 

[jim@olpc2 ~]$ ssh-keygen 

Generating public/private rsa key pair. 

Enter file in which to save the key (/home/jim/. ssh/id_rsa) : 

Por defecto ssh-keygen genera una clave RSA, que es el tipo que 
requerimos. Tambien por defecto pone lo archivos de claves en un 
directorio llamado /tudirectorio/.ssh y esto tambien lo queremos, de 
manera que NO ingreses nombre de archivo alguno cuando lo pida. Solo 
oprime la tecia Enter para continuar. 

[jim§olpc2 -]$ ssh-keygen 

Generating public/private rsa key pair. 

Enter file in which to save the key (/home/jim/. ssh/id_rsa) : 

Created directory ' /home/jim/ . ssh ' . 

Enter passphrase (empty for no passphrase): 
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Ahora bien, SI queremos una passphrase (frase de paso) aqui. Esta 
frase de paso es como una contrasena que es usada con las claves 
publicas y privadas para efectuar la encriptacion. Cuando la escribas no 
podras ver las letras. Por ello se te pedira escribiria dos veces y asi 
confirmar que ambas veces la has escrito de la misma forma. 

[jim@olpc2 ~]$ ssh-keygen 

Generating public/private rsa key pair. 

Enter file in which to save the key (/home/jim/. ssh/id_rsa) : 

Created directory ' /home/jim/ . ssh ' . 

Enter passphrase (empty for no passphrase): 

Enter same passphrase again: 

Your identification has been saved in /home/jim/ . ssh/id_rsa. 

Your public key has been saved in /home/jim/ . ssh/id_rsa. pub . 

The key fingerprint is: 

d0:fe:c0:0c:le:72:56:7a:19:cd:f3:85:c7:4c:9e:18 

jim@olpc2 . Simmons 

The key's randomart image is: 

+ -- [ RSA 2048] + 

00 E=. 
+0+ . += . 
. B + 0.00 
= 

. s 





Cuando selecciones la frase de paso o contrasena recuerda que debe ser 
algo que puedas escribir confiablemente sin verlo y sera mas efectivo si 
no escojes una palabra que se encuentre en el diccionario, pues estas 
son facilmente quebrantables. Cuando yo necesito generar una 
contrasena utilizo la herramienta que puedes encontrar en 
http://www.multicians.org/thvv/gpw.html. Esta herramienta genera una 
cantidad de palabras pronunciables sin sentido. Escoje una que te guste 
y utilizala. 

Ahora echa una mirada dentro del directorio .ssh. Por convencion, cada 
archivo o directorio que empieza con un punto es considerado oculto por 
Linux, asi que no se mostrara en el gestor de archivos de GNOME a 
menos que uses la opcion Mostrar Archivos Ocultos en el menu Ver. 
Cuando veas los contenidos de este directorio observaras dos archivos: 
id_rsa e id_rsa.pub. La clave publica estara en id_rsa.pub. Intenta abrir 
ese archivo con gedit (Abrir con editor de texto) y veras algo asi: 
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Id Fsa.pub {-l.ish) - OEdlt 



He Edit View searcn Tbols Documents Help 



New Open 



Save 



tsSI 
ftlnt. 



Urda Reao 



09 - BSl 

Cut Copy f^ste 



Find Replace 



Ij id_r5a.pub ^ 

ssn- rsa AM«E3niaciyc?EM/UEiwiAAqEflwa<j3aL//uriyL37J(i)ZBicsj(R2VpU6K:cj«ca]qDn\;t0Eiu-iH™fiFr5 
-t[;a<WCc*»yUrKsivir7hZaYkyCie/f3J5fMBBvYf 

iTz5bKJVWc¥hPBFPdh^Jrt5jr*iUi4ICylCi^icCeYa*l>:5pjK«HIWOoeh3YdPWnU5eF50w3WqoSnDH3uair^JAtW'2PC5W=t:AFM 
^d5bl3*ITl.G3hffiBhpV3dTV[M'N0KhCIi9tMpiSpHRlU(:pMf/5H5CJKKzC2yhBiaLTnW5ed.wTJcJqc(B4rT/v3KF-i«765X5U3TB6Wy-i«iiig/ 
IE JY5 DBqcPZTCWJ9M J rwrcrXReiio un5pD04DM: 5— ] IT^lp €2 . 51riinctl5 



Al crear tu cuenta en git.sugarlabs.org habra un casillero para colocar tu 
clave SSH publica. Para hacer eso elije Select All (Seleccionar Todo) del 
menu Edit (Editar) de gedit, luego Copy and Paste (Copia y pega) en el 
cannpo provisto en el formulario web. 

Crear un proyecto nuevo 



Voy a crear un proyecto nuevo en Git para los ejemplos de este libro. 
Necesito ingresar con mi nueva cuenta y hacer die en el enlace New 
Project (Proyecto nuevo) que vimos anteriormente. Obtengo el 
siguiente formulario, que ya comence a llenar: 

Create a new project 

Title 



Mate Your Own Sugar Activities Exampies 



Slug (Tor uris ete) 

myo-sugar-activitiea-axamplBB 



Categories (space seperated] 



activities 



License 



3 



GNU General PutjIlG Lioensev! 



86 



El Title (Titulo) es usado en el sitio web; el Slug (Abreviatura) es una 
version breve del titulo sin espacios, la cual sera usada como nombre del 
repositorio Git. Las Categories (Categorias) son opcionales. La License 
(Licencia) es GPL v2 para mis proyectos. Puedes elegir entre las licencias 
ofrecidas en la lista para tus proyectos, y puedes cambiar la licencia 
posteriormente si quieres. Tambien necesitaras ingresar una 
Description (Descripcion) para tu proyecto. 

Una vez que hayas hecho esto, podras hacer die en el entrada mainline 
para el proyecto (como hicimos con Read Etexts antes) y ver algo asi: 

Repositories 
Oveffviaw Commhs SouiceTrae Commants (0] Me^e raquastsfO) 

"mainline" repository in Make Your Own Sugar Activities Book Examples 

Public clone url: git://git.sugarlal)s.Qrg/myo-SLigar-actiuities-exani)les/trainline. git fibibimo . 



Voucan elorethis ispository with Ihe bllowing command: 

git clone gitV/^lt.sugarlatJS.Qrg/iyQ-^jgar-activlties-eKainptes/ialrllne.git 

HTTP dona url: http;//git.5Ugarlab5.aT'g/git/inyo-siigar-act±vitie5-exa[ipl0^/iiBinl-Ln@.git i,km inFa.. 

You can ciorw tiiis psposilnry WEtli line lollowing command: 

git clone htt|>: //git. sugarlabs.or^/git/Byo-sugar-actlvi ties- exaiples/nainllne. git 

(ncdethElcbninB over HTTP BS^^&lowBr. bul Lfi«ful FyaiiebahrxlaFiienBii] 



Push url: gitarlojsg^it.sugarlabs. org :iTyo-sugar' action. ties -exan^les/nainllrie. git [uiiiii^irii]!'.'] 

Voucan run "jit push git[iri0iis@git,siigarlabs.org;ii^ct-sujar-actlvitie3-e:(ampl.es/inair;llne.glt",or youes 
git renote add origin gitoriousftit, sugdrlabs.orgiiuyO'Sugar-attivities-exanples/nairline.git 

# to PUSH trte isstsr bfantn to tfte origin resMe we aaaea above; 
git puid origid m«ter 

# after that yoj c^r^ just do: 
git pusn 



Activities 

El proximo paso es convertir nuestro proyecto en un repositorio local de 
Git, anadirle los archivos, y luego subirlos al repositorio en 
git.sugarlabs.org . Necesitamos hacer esto porque no es posible clonar 
un repositorio vacio, y nuestro repositorio remoto ahora se encuentra 
vacio. Para superar este problema enviaremos nuestro repositorio local 
hacia el nuevo repositorio remoto que acabamos de crear, luego 
clonaremos el repositorio remoto y borraremos nuestro proyecto y su 
repositorio Git. A partir de entonces haremos todo nuestro trabajo desde 
el repositorio clonado. 

Este proceso puede recordarles la cita de Edward Albee, "Algunas veces 
una persona debe desviarse bastante de su rumbo para desandar 
correctamente una pequena distancia".- Afortunadamente solo 
necesitamos hacerlo una vez por proyecto. Ingresa los comandos que 
aparecen en negritas despues de cambiarte al directorio de tu proyecto: 
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git init 

Initialized empty Git repository in 

/home/jim/olpc/bookexamples/ . git/ 

git add * . py 

git add activity 

git add MANIFEST 

git add .gitignore 

git commit -a -m "Create repository and load" 

[master (root-commit) 727bfe8] Create repository and load 

9 files changed, 922 insertions(+) , deletions(-) 

create mode 100644 .gitignore 

create mode 100644 MANIFEST 

create mode 100755 ReadEtexts . py 

create mode 100644 ReadEtextsActivity . py 

create mode 100644 ReadEtextsActivity2 . py 

create mode 100644 activity/activity . info 

create mode 100644 activity/read-etexts . svg 

create mode 100755 setup. py 

create mode 100644 toolbar. py 

Lo que hice fue crear un repositorio Git local vacio con git init, luego 
use git add para anadir los archivos importantes a el. (De hecho git 
add no anade nada por si mismo, solo le dice a Git que anada el archivo 
en el siguiente git commit). Finalmente git commit con las opciones 
mostradas colocara la ultima version de estos archivos en mi nuevo 
repositorio local. 

Para subir este repositorio local a git.sugarlabs.org usamos los 
comandos de la pagina web: 

git remote add origin \ 
gitorious§git .sugar labs .org:\ 
myo-sugar-activities-examples/mainline . git 
git push origin master 

Counting objects: 17, done. 

Compressing objects: 100% (14/14), done. 

Writing objects: 100% (15/15), 7.51 KiB, done. 

Total 15 (delta 3), reused (delta 0) 

To gitorious@git .sugarlabs.org :myo- sugar -activities -examples/ 

mainline . git 

2cb3ale. .700789d master -> master 
=> Syncing Gitorious... 
Heads up: head of changed to 

700789d3333a7257999d0a69bdcafb840e6adc09 on master 
Notify cia.vc of 727bfe819d5b7b70f4f2b31d02f5562709284ac4 on 
myo- sugar -activities -examples 

Notify cia.vc of 700789d3333a7257999d0a69bdcaf b840e6adc09 on 
myo -sugar -activities -examples 
[OK] 
rm * 

rm activity -rf 
rm .git -rf 
cd ~ 

rm Activity/ReadEtextsII 
mkdir olpc 
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cd olpc 

mkdlr bookexamples 

cd bookexamples 

git clone \ 

git : //git . sugar labs. org/\ 

myo- sugar -activities -examples/mainline. git 

Initialized empty Git repository in 

/home/jim/olpc/bookexamples/mainline/ . git/ 

remote: Counting objects: 18, done. 

remote: Compressing objects: 100% (16/16), done. 

remote: Total 18 (delta 3), reused (delta 0) 

Receiving objects: 100% (18/18), 8.53 KiB, done. 

Resolving deltas: 100% (3/3), done. 

Las lineas en negritas son comandos para ingresar, y todo lo demas son 
mensajes que Git envia a la consola. He dividido algunos de los 
comandos Git mas largos con la barra invertida (\) para que luzcan 
mejor en una pagina impresa, asi como algunas lineas largas que 
normalmente se mostrarian en una linea, por el mismo motivo. 
Probablemente no este claro lo que estamos haciendo o por que, asi que 
vayamos paso a paso: 

• El primer comando git remote add origin le dice al repositorio 
remoto de Git que le estaremos enviando cosas desde nuestro 
repositorio local. 

• El segundo comando git pusli origin master envia realmente el 
repositorio Git local al remoto y sus contenidos se copiaran. Cuando 
ingreses este comando se te pedira la frase de paso (contrasena) de 
la clave SSH que creaste en la seccion anterior. Si lo deseas, GNOME 
puede recordar esta frase y luego la ingresaria automaticamente 
para cada comando Git. Seguira asi hasta que cierres la sesion o 
apagues la maquina. 

• El siguiente paso es borrar nuestros archivos existentes y nuestro 
repositorio local de Git (el cual esta contenido en el directorio oculto 
.git), rm .git -rf quiere decir "Borra el directorio .git y todo lo que 
encuentres en el", rm es un comando Unix, no un comando de Git. 
Si lo deseas puedes borrar los archivos existentes despues de crear 
el repositorio clonado en el paso siguiente. Nota que el comando rm 
Activity/ReadEtextsll, el cual borra el enlace simbolico del proyecto 
viejo que creamos al ejecutar ./setup. py dev. Necesitaremos ir al 
directorio clonado de nuestro proyecto y ejecutar esto nuevamente 
antes de poder probar nuestra Actividad otra vez. 

• Ahora ejecutamos el comando git clone de la pagina web. Esto toma 
el repositorio Git remoto al cual acabamos de anadirle el archivo 
MANIFEST, y crea un nuevo repositorio local en el directorio 
/tudirectorio/olpc/boolcexam pies/mainline. 

Finalmente tenemos un repositorio local que podemos usar. Bueno, no 
del todo. Podemos consignar nuestro codigo en el, pero no podemos 
subir nada de vuelta al repositorio remoto porque nuestro repositorio 
local no se encuentra correctamente configurado. 
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Lo que necesitamos hacer es editar el archive config en el directorio 
.git de /tudirectorio/olpc/bookexam pies/mainline. Podemos usar 
gedit para ello. Necesitamos cambiar la linea que comienza con url = 
para apuntar a la Push uri (UrI para subir) la cual se muestra en la 
pagina web de mainline. Cuando termines el archivo config lucira algo 
asi: 

[core] 

repositoryformatversion = 

filemode = true 

bare = false 

logallref updates = true 
[remote "origin"] 

url = gitorious@git.sugarlabs.org: 
myo-sugar-activities-examples/mainline . git 

fetch = +ref s/heads/* : ref s/remotes/origin/* 
[branch "master"] 

remote = origin 

merge = ref s/heads/master 

La linea en negrita es la unica que se modifica. Esta separada aqui para 
haceria entrar en una pagina impresa. En tus propios archivos debe 
estar todo en una linea sin espacios entre los dos puntos (:) al final de la 
primera linea y el principio de la segunda linea. 

De ahora en adelante quien quiera trabajar sobre tu proyecto puede 
obtener una copia local del repositorio Git haciendo esto desde el 
directorio donde quiere que vaya el repositorio: 

git clone git ://git .sugarlabs.org/\ 
myo-sugar-activities-examples/mainline . git 

Necesitara cambiar su archivo .git/config igual como acabamos de 
hacer, y luego estara listo para empezar. 

Uso habitual de Git 

Aunque configurar los repositorios para comenzar es tedioso, el uso 
habitual no lo es. Hay tan solo algunos comandos con los que 
necesitaras trabajar. Cuando interrumpimos teniamos un repositorio en 
/tudirectorio/olpc/boolcexam pies/mainline con nuestros archivos en 
el. Necesitaremos ahadir tambien cualquier archivo nuevo que creemos. 

Usamos el comando git add para decirle a Git que queremos que 
guarde un archivo en particular. Esto no guarda nada, solo le comunica a 
Git nuestras intenciones. El formato del comando es simplemente: 

git add nombre_archivo_o_directorio 
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Hay archives que no queremos anadir a Git, para empezar aquellos que 
terminan en .pyc. Si nunca les liacemos git add entonces nunca seran 
anadidos, pero Git constantemente nos preguntara por que no los 
anadimos. Afortunadamente hay una forma de decirle a Git que 
realmente, absolutamente no queremos anadir esos archivos. 
Necesitamos crear un archivo llamado .gitignore usando gedit y colocar 
entradas asi: 

# . pyc 

# .e4p 

# . zip 

. eric4project/ 
. ropeproject/ 

Estas entradas tambien ignoraran archivos de proyectos de Eric, 
archivos zip y archivos que contengan libros electronicos- . Una vez que 
tenemos este archivo en el directorio de mainline, podemos ahadirlo al 
repositorio: 

git add .gitignore 

git commit -a -m "Add .gitignore file" 

De ahora en adelante Git no insistira en anadir archivos .pyc u otros 
archivos no deseados que coincidan con los patrones de busqueda. Si 
hay otros archivos que no queremos en el repositorio, podemos 
ahadirlos a .gitignore sea con sus nombres completos o con patrones de 
busqueda como *.pyc. 

Ademas de anadir archivos a Git tambien los podemos eliminar: 
git rm archivo 

Notese que esto solo le dice a Git que de ahora en adelante no le hara 
seguimiento a este archivo, lo cual tomara efecto en la siguiente 
consignacion (commit). Las versiones anterires del archivo seguiran en 
el repositorio. 

Si deseas ver que cambios seran aplicados en la proxima consignacion, 
ejecuta esto: 

git status 

# On branch master 

# Changed but not updated: 

# (use "git add <f ile> . . . " to update what will 

# be committed) 
# 

# modified: ReadEtextsActivity . py 
# 

no changes added to commit (use "git add" and/or 
"git commit -a") 
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Finalmente, para colocar los ultimos cambios en el repositorio, haz esto: 

git commit -a -iti "Change use of instance directory to tmp" 

Created commit a687b27: Change use of instance 
directory to tmp 
1 files changed, 2 insertions(+), 2 deletions(-) 

Si omites la opcion -m, un editor aparecera y podras escribir un 
comentario, luego grabar y salir. Desafortunadamente el editor por 
omision es vi, un editor antiguo de modo texto que no es tan amigable 
como gedit. 

Cuando hayamos hecho todos nuestros cambios podemos enviarlos al 
repositorio central usando git push: 

git push 

Counting objects: 5, done. 

Compressing objects: 100% (3/3), done. 

Writing objects: 100% (3/3), 322 bytes, done. 

Total 3 (delta 2), reused (delta 0) 

To gitorious§git . sugarlabs .org : 

myo- sugar -activities -examples/main line .git 

700789d . .a687b27 master -> master 
=> Syncing Gitorious... 
Heads up: head of changed to 

a687b27e2f034e5al7d2ca2fe9f2787c7f633e64 on master 
Notify cia.vc of a687b27e2f034e5al7d2ca2fe9f2787c7f 633e64 
on myo-sugar-activities-examples 
[OK] 



Podennos obtener los ultimos cambios de otros desarrolladores haciendo 
git pull: 

git pull 

remote: Counting objects: 17, done. 

remote: Compressing objects: 100% (14/14), done. 

remote: Total 15 (delta 3), reused (delta 0) 

Unpacking objects: 100% (15/15), done. 

From gitorious@git .sugarlabs. org: 

myo -sugar -activities -examples/main line 

2cb3ale . . 700789d master -> origin/master 
Updating 2cb3ale . . 700789d 
Fast forward 

. gitignore 

MANIFEST 



ReadEtexts . py 
ReadEtexts Activity. py 
ReadEtextsActivity2 . py 
+++++++++++++++++++ 
activity/activity. info 
activity/read-etexts . svg 
setup . py 
toolbar . py 
9 files changed, 921 insertions(+) , 241 deletions(-) 



1 6 


+ 


1 244 


-!-__________________________ 




1 182 


+++++++++++++++++++++++++++ 


1 182 


+++++++++++++++++++++++++++ 


1 311 


+++++++++++++++++++++++++++ 


1 9 


++ 


1 71 


+++++++++++ 


1 21 


+++ 


1 136 


++++++++++++++++++++ 
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create mode 100644 .gitignore 

create mode 100755 ReadEtexts . py 

create mode 100644 ReadEtextsActivity . py 

create mode 100644 ReadEtextsActivity2 . py 

create mode 100644 activity/activity .info 

create mode 100644 activity/read-etexts . svg 

create mode 100755 setup. py 

create mode 100644 toolbar . py 



1. NT: En el texto en ingles Git Along Little Dogies - la traduccion seria 
muevanse pequenos terneros, fuera. Git Along, Little Dogies es una 
balada tradicional de los vaqueros. — 

2. NT: En el texto en ingles: "Sometimes a person has to go a very long 
distance out of his way to come back a short distance correctly".— 

3. NT: ebooks en el original^^ 

4. Traducido Sebastian Silva y Laura Vargas 
proyectomalla(g)somosazucar.org < 
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J. ^ • Internacionalizarse con Pootle 



Introduccion 

El objetivo de Sugar Labs y One Laptop Per Child es educar a todos los 
ninos del mundo, y no podemos hacer eso con Actividades que solo estan 
disponibles en un idioma. Es igualmente cierto que hacer versiones 
separadas de cada Actividad para cada idioma no va a funcionar, y 
esperar que los desarrolladores de Actividades hablen muchos idiomas 
no es realista. Necesitamos una manera para que los desarrolladores de 
Actividades se puedan concentrar en la creacion de las Actividades y que 
los que pueden traducir hagan precisamente eso. Afortunadamente, 
esto es posible y la forma en que se hace es mediante el uso de gettext. 

Obtener texto con gettext 

Seguramente recuerdas que nuestro ultimo ejempio de codigo uso una 
importacion extraha: 

from gettext import gettext as _ 

La funcion "_()" se usa en sentencias como esta: 
self. back. set_tooltip(_( ' Back ' ) ) 

En aquel momento se explico que esta funcion singular se utilizo para 
traducir la palabra "Back" (Volver) en otros idiomas, de modo que 
cuando alguien ve la descripcion del boton "Back", vera el texto en su 
propio idioma. Tambien se dijo que si no era posible traducir este texto, 
el usuario veria la palabra "Back", sin traducir. En este capitulo vamos a 
aprender mas sobre como funciona esto y lo que tenemos que hacer 
para apoyar a los voluntarios que traducen las cadenas de texto a otros 
idiomas. 

Lo primero que hay que aprender es la manera correcta de armar las 
cadenas de texto a traducir. Este es un problema cuando las cadenas de 
texto son frases reales que contienen informacion. Por ejempio podemos 
escribir un mensaje de la siguiente manera: 

message = _("User ") + username + \ 
_(" has joined the chat room.") 
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Esto podria funcionar, pero las cosas serian demasiado complicadas para 
el traductor. Tiene dos cadenas separadas para traducir y no hay pista 
de que apareceran juntas. Es mucho mejor hacer esto: 

message = _("User %s has joined the chat room.") % \ 
username 

Si sabemos que ambas declaraciones producen la misma cadena 
resultante, es facil ver por que un traductor prefiere la segunda opcion. 
Usa esta tecnica siempre que necesites una frase que tenga alguna 
informacion que se deba insertar en ella. Tambiene es bueno tratar de 
limitarse a un unico codigo de formato (el %s) por frase. Si utilizas mas 
de uno puedes causarle problemas al traductor. 



Creando el pot 



Asumiendo que cada cadena de texto que puede ser mostrada por 
nuestra Actividad se pasa a traves "_()", el siguiente paso es generar un 
archivo pot. Puedes hacer esto ejecutando setup. py con una opcion 
especial: 

. /setup. py genpot 

Esto crea un directorio llamado po y pone un archivo >lctiV/tyWame. pot 

en ese directorio. En el caso de nuestro ejempio, el proyecto 
ActivityName, es ReadEtextsll. Este es el contenido de ese archivo: 

# SOME DESCRIPTIVE TITLE. 

# Copyright (C) YEAR THE PACKAGE'S COPYRIGHT HOLDER 

# This file is distributed under the same license as the 

# PACKAGE package. 

# FIRST AUTHOR <EMAIL§ADDRESS>, YEAR. 
# 

#, fuzzy 

msgid "" 

msgstr "" 

"Project-Id-Version: PACKAGE VERSION\n" 

"Report-Msgid-Bugs-To : \n" 

"POT-Creation-Date: 2010-01-06 18 : 31-0600\n" 

"PO-Revision-Date: YEAR-MO-DA HO: MI+ZONE\n" 

"Last-Translator: FULL NAME <EMAIL@ADDRESS>\n" 

"Language-Team: LANGUAGE <LL@li.org>\n" 

"MIME-Version: 1.0\n" 

"Content-Type: text/plain; charset=CHARSET\n" 

"Content-Transfer-Encoding: 8bit\n" 

#: activity/activity . info : 2 
msgid "Read ETexts II" 
msgstr "" 

#: toolbar . py: 34 
msgid "Back" 
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msgstr "" 

#: toolbar . py:40 
msgid "Forward" 
msgstr "" 

#: toolbar . py: 115 
msgid "Zoom out" 
msgstr "" 

#: toolbar . py:120 
msgid "Zoom in" 
msgstr "" 

#: toolbar . py:130 
msgid "Fullscreen" 
msgstr "" 

#: ReadEtextsActivity2.py :34 
msgid "Edit" 
msgstr "" 

#: ReadEtextsActivity2.py :38 
msgid "Read" 
msgstr "" 

#: ReadEtextsActivity2. py :46 
msgid "View" 
msgstr "" 

Este archive contiene una entrada para cada cadena de texto en nuestra 
Actividad (msgid) y un lugar para poner una traduccion de esa cadena 
(msgstr). Copias de este archive se haran en el servidor Pootle para cada 
idioma que desee, y las entradas msgstr seran rellenadas por 
traductores voluntaries. 

Subiendo a Pootle 

Antes que eso puede suceder, necesitamos subir nuestro archive POT en 
Pootle. Lo primero que tenemos que hacer es colocar el nuevo directorio 
en nuestro repositorio de Git y subirlo (push) a Gitorious. Debemos 
estar ya familiarizados con los comandos necesarios: 

git add po 

git commit -a -m "Add POT file" 

git push 

Luego necesitamos darle al usuario autoridad "pootle" para hacer 
"commit" en nuestro proyecto Git. Para hacerlo, hay que ir a 
git.sugarlabs.org , iniciar sesion, y encontrar la pagina del proyecto y 
haga die en el enlace "mainline". En la nueva pagina deberas ver esto: 
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Project: Make Your Own Sugar Activities Bool< 
Examples 

Maintainer: jdsimmons 
Created: 03 Jan 21:46 

Clone repository 
Request merge 
Add committer 



Committers 

jdsimmons (omner) 



Haz die en el enlace Add committer y escribe el nombre pootle en el 
formulario al que te Neva. Cuando regreses a esta pagina pootle 
aparecera listado bajo Committers. 

El siguiente paso es ir al sitio web http://bugs.sugarlabs.org y registrarte 
para obtener un identificador de usuario. Con este usuario puedes abrir 
un "ticket" como este: 
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sugarlabs 



lagged 

Wiki 



Create New Ticket 



Summary: 
Descriptian: 

Typa: 

Milestone: 

Version : 

Keywords; 

DiEtributioiVOS: 

Assign to; 








Add project "Maks Your Own Sugai Ac(M(ies Book Examples" lo Pootle 




B I A tt m'^ 11^ B 






User peotlE ia Blcendy a coinmittEi: 


£cl: this praJECt in -jit. 












task 2\ 


Priority: | UrspBcified tay Maintainar jj 




Unspeciliad byRsleaseTeafm ^i 


Component: [locBlizatioii ^i 


Unspeciliad _^ 

1 


Severity: j Unspecified _^ 




Cc: 




Unspe dried 


't 


Bug Status: [Ne»sr ^ | 


d 









El campo Component debe ser ingresado como "localization" y el campo 
Type debe ser "tasl<". 

Lo creas o no, esto es todo lo que necesitas hacer para que tu actividad 
pueda ser traducida. 

No prestes atencion al hombre detras de la cortina 

Despues de esto todavia debes hacer algunas cosas para obtener 
traducciones de Pootle en tu Actividad. 
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• Al agregar cadenas de texto (etiquetas, mensajes de error, etc) a tu 
Actividad, siempre utiliza la funcion _() con ellos para que puedan 
ser traducidos. 

• Despues de agregar nuevas cadenas ejecuta ./stup.py genpot para 
recrear el archivo POT. 

• Despues de esto, hacer "commit" de los cambios y subirlos ("push") 
a Gitorious. 

• De vez en cuando, y especialmente antes de liberar una nueva 
version, hacer un git pull. Si hay archivos de localization ahadidos 
a Gitorious esto permitira que puedas obtenerlos. 

• Despues de conseguir estos archivos, debes ejecutar ./setup. py 
fix_manifest para incluir los nuevos archivos obtenidos en el 
archivo MANIFEST. Despues edita el archivo MANIFEST con gedit 
para eliminar cualquiera entrada no deseada (pueden ser los 
archivos de proyecto del editor Eric, etc.). 

La traduccion con Pootle creara un gran numero de archivos en el 
proyecto, algunos en el directorio po y otros en un nuevo directorio 
llamado locale. Siempre y cuando estos aparezcan listados en el archivo 
MANIFEST, se incluiran en el archivo .xo que vas a utilizar para distribuir 
tu Actividad. 
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C'est Magnifique! 



Esta es una captura de pantalla de la version en frances de Read Etexts 
leyendo la novela de Julio Verne "Le tour du monde en quatre-vingts 
jours": 



O Ofl^'"''' # u 


Adivftc 


tiiilcr Lirt Voir 1 Rnricr 




ooooooooooooooo <><><><><><><>< ><><>< 




LETOUR DU MONDE 




EM 




OUATRE-VlNGTSjOURS 




par Jules Verne 




I 




DANS LEQUEL PHI LEAS FOGG ET PASSEPARTOUT 




S'ACCEFTENT RECIPROQUEMENT L'UN COMME MAITRE, 




L'AUTRE COMME DOMESTIOUE 




En I'annee 1872, la malson portant le niimero 7 de Saville-row, Burlington Gardens ^ 




-- maisan dans laqueile Sheridan mourut en 1314 --, etait habitee par Phileas Fogg, 1 




esq., run des rjiembres les plus singuliers et les plus remarques du Reform-Club 6e 1 




Londres, bien qu'ii semblat prendre a tache de ne rien faire qui put attirer 1 




I'attention. | 



Hay razones para creer que el libro tambien esta en frances. 
1 



1. Traducido Gonzalo Odiard, Argentina- 
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J. ^ • Distribuir tu Actividad 



Elige una licencia 



Antes de dar tu Actividad a cualquier persona, necesitas elegir bajo que 
licencia sera distribuida. Comprar software es como comprar un libro. 
Hay ciertos derechos que tu tienes con un libro y que otras personas no 
tienen. Si tu compras un ejemplar de "El codigo Da Vinci" tienes el 
derecho a leerlo, a prestarlo, venderlo a una tienda de libros usados, o a 
quemarlo. Tu no tienes el derecho a hacer copias de el o hacer una 
pelicula sobre el. Con el software pasa lo mismo, pero a veces es peor. 
Los acuerdos de licencia rutinariamente se aceptan haciendo die en un 
boton, pero podrian no permitirte vender el software cuando hayas 
terminado con el, o incluso regalarlo. Si vendes tu computadora es 
posible que el software que compraste solo es bueno para ese equipo, y 
solo mientras seas tu el dueno de la computadora. (Tu puedes conseguir 
buenas ofertas en computadoras reacondicionadas sin ningun sistema 
operativo instalado por esa misma razon). 

Si estas en el negocio de la venta de software, podrias tener que 
contratar a un abogado para redactar un acuerdo de licencia, pero si 
estas regalando el software hay varias licencias estandar que puedes 
elegir de forma gratuita. El mas popular, por lejos, se llama la General 
Public License (en espahol, Licencia Publica General) o GPL. Al igual que 
las licencias que Microsoft utiliza, permite que las personas que reciben 
tu programa puedan hacer algunas cosas con ellos pero no otras. Lo mas 
interesante no es lo que les permite hacer (que es practicamente todo), 
sino lo que les prohibe hacer. 

Si alguien distribuye un programa licenciado bajo la GPL, es tambien 
necesario poner el codigo fuente del programa a disposicion de 
cualquiera que lo desee. Esa persona puede hacer lo que quiera con el 
codigo, con una restriccion importante: si se distribuye un programa 
basado en el codigo ese, tambien debe licenciar aquel codigo usando la 
licencia GPL. Esto hace que sea imposible que alguien tome un trabajo 
con licencia GPL, lo mejore y lo venda a alguien sin darle el codigo 
fuente de la nueva version. 



101 



Mientras que la licencia GPL no es la unica licencia disponible para las 
Actividades que se distribuyen en http://activities.sugarlabs.org. todas 
las licencias exigen que alguien que reel be la Actividad tambien obtenga 
el codigo fuente completo de ella. Tu ya has cumplido con esta 
obligacion al poner tu codigo fuente en Gitorious. Si has utilizado codigo 
de una Actividad existente con licencia GPL, debes licenciar tu propio 
codigo de la misma manera. Si has utilizado una gran cantidad de codigo 
de este libro (que tambien esta bajo licencia GPL) puede ser necesario 
que uses la GPL tambien. 

iDebes preocuparte por las licencias? En realidad no. La unica razon por 
la que querrias usar una licencia distinta de la GPL es si quisieras vender 
tu Actividad en lugar de regalarla. Considera lo que tendrias que hacer 
para que eso sea posible: 



• Tendrias que usar algun otro lenguaje que no sea Python, para que 
puedas dar a alguien el programa, sin darle el codigo fuente. 

• Tendrias que tener tu propio repositorio de codigo fuente no 
disponible al publico en general y hacer arreglos para que los datos 
se respladen regularmente. 

• Tendrias que tener tu propio sitio web para la distribucion de la 
Actividad. El sitio web deberia ser configurado para aceptar pagos de 
alguna manera. 

• Tendrias que anunciar ese sitio web de alguna manera o nadie 
sabria que tu Actividad existe. 

• Tendrias que tener un abogado para que elabore una licencia para 
tu Actividad. 

• Tendrias que idear un mecanismo para impedir a tus clientes 
distribuir copias de tu Actividad. 

• Tendrias que crear una actividad tan increiblemente inteligente que 
nadie mas pueda hacer algo similar y regalarlo. 

• Tendrias que lidiar con el hecho de que tus "clientes" serian los 
nihos, sin dinero o tarjetas de credito. 

En resumen, activities.sugarlabs.org no es el iPhone App Store. Es un 
lugar donde los programadores comparten y construyen sobre el trabajo 
de otro y dan los resultados a los nihos de forma gratuita. La GPL 
fomenta a que eso pase, y recomiendo que elijas esa como tu licencia. 

Agrega la licencia como comentario en tu codigo 
Python 

En la parte superior de cada archivo de codigo fuente Python de tu 
proyecto (excepto setup. py, que ya esta comentado) pon comentarios 
como este: 
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# nombredelarchivo descripcion 
# 

# Copyright (C) 2011 Tu Nombre Aqui 
# 

# This program is free software; you can redistribute it 

# and/or modify it under the terms of the GNU General 

# Public License as published by the Free Software 

# Foundation; either version 2 of the License, or 

# (at your option) any later version. 
# 

# This program is distributed in the hope that it will 

# be useful, but WITHOUT ANY WARRANTY; without even 

# the implied warranty of MERCHANTABILITY or FITNESS FOR 

# A PARTICULAR PURPOSE. See the GNU General Public 

# License for more details. 
# 

# You should have received a copy of the GNU General 

# Public License along with this program; if not, write 

# to the Free Software Foundation, Inc., 51 Franklin 

# St, Fifth Floor, Boston, MA 02110-1301 USA 

Si el codigo esta basado en el codigo de otra persona, debes mencionarlo 
como una cortesia. 

Crea un archive .xo 

Asegurate de que el archive activity. info tiene el numero de version que 
deseas dar a tu Actividad (en la actualidad debe ser un entero positivo) y 
ejecuta el siguiente comando: 

. /setup. py dist_xo 

Esto creara una carpeta dist si no existe y pondra un archivo llamado 
algo asi como ReadETextsll-l.xo en ella. El "1" indica la version 1 de la 
Actividad. 

Si has hecho todo bien, este .xo debe estar listo para distribuir. Puedes 
copiarlo a una unidad de disco USB (pendrive) e instalarlo en una XO o 
en otra unidad de disco USB corriendo Sugar on a Stick. Probablemente 
deberias hacerlo antes de distribuiria por cualquier inconveniente. Me 
gusta vivir con las nuevas versiones de mis actividades durante 
aproximadamente una semana antes de ponerlas 
en activities.sugarlabs.org. 

Ahora seria un buen momento para ahadir dist a tu archivo .gitignore, 
y despues, hacer un commit y ponerlo en Gitorious. Tu no quieres 
tener copias de tus archivos .xo en Git. Otra buena cosa para hacer en 
este momento seria asignar etiquetas a tu repositorio Git con el 
numero de version, para que puedas identificar que codigo va con que 
version. 
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git tag -m "Version 1" vl HEAD 
git push --etiquetas 

Agrega tu Actividad a ASLO 

Cuando estes listo para enviar el archive .xo a ASLO necesitaras crear 
una cuenta como se hace con otros sitios web. Cuando hayas entrado alii 
puedes encontrar un enlace a Tools (Herramientas) en la esquina 
superior derecha de la pagina. Has die alli y veras un menu con una 
opcion para: Developer Hub (Centro de Desarrolladores), en la que 
deberas hacer die. Eso te llevara a la pagina donde puedes agregar 
nuevas Actividades. Lo primero que te piden a la hora de establecer una 
nueva Actividad es la licencia que vas a utilizar. Despues de eso, no 
deberias tener problemas para dejar tu Actividad establecida. 

Tienes que crear un icono para la Actividad como un archivo .gif y crear 
capturas de pantalla de la Actividad en accion. Puedes hacer ambas 
cosas con GIMP (GNUImage Manipulation Program). Para el icono todo 
lo que necesitas hacer es abrir el archivo .svg con el GIMP e ir a Save as 
(Guardar como) y elegir el formato .gif. 

Para las capturas de pantalla usa el emulador de Sugar para mostrar tu 
Actividad en accion, a continuacion, utiliza la opcion de pantalla del 
submenu Create (Crear) del menu File (Archivo) con las siguientes 
opciones: 



'" Captura de pantalla 

Area 

® Capturar una sola ventana 

D Incluir decoracion de la ventana 

O Capturar la pantalla completa 
D Incluir el puntero del raton 

O Selecclonar una region de captura 
Retraso 

10 ^ segundos 



A\ finatizar la pausa, pulse sobre una ventana para capturarla. 



Ayuda 



Cancelar 



Intercambiar 



104 



Esto le indica a GIMP que espere 10 segundos y luego tome una captura 
de pantalla de la ventana en la que hayas hecho die con el raton. Sabras 
que los 10 segundos se terminan porque el puntero del raton cambiara 
de forma a un signo de mas ( + ). Tambien le dice que no incluya la 
decoracion de la ventana (esto es, la barra de titulo y el borde). Como las 
ventanas de SUGAR no tienen decoraciones, esto eliminara las 
decoraciones utilizadas por el emulador de Sugar y te dara una captura 
de pantalla que se ve exactamente como una Actividad corriendo en 
Sugar. 

Cada Actividad necesita una captura de pantalla, pero puedes tener mas 
si lo deseas. Las capturas ayudan a promocionar la Actividad y ensenan a 
aquellos que la utilizaran lo que la Actividad puede hacer. Por desgracia, 
ASLO no puede mostrar imagenes en una secuencia predecible, por lo 
que no es apropiada para mostrar los pasos a llevar a cabo. 

Otra cosa que debes proporcionar es una pagina para tu actividad. 
Para Read Etexts es esta: 

http://wiki.sugarlabs.org/go/Activities/Read_Etexts 

Si, un sitio web mas para obtener una cuenta. Una vez hecho puedes 
especificar un vinculo a /go/Act i vi ties/a I gun_nomb re y al hacer die en 
ese enlace de la Wiki se va a crear una pagina para ti. El software 
utilizado para el wiki es MediaWiki, el mismo que utiliza la Wikipedia. 
Tu pagina no tiene por que ser tan complicada como la mia, pero 
definitivamente deberia proporcionar un enlace a tu codigo fuente en 
Gitorious. 



1. Traducido Alan Aguiar, Uruguay- 



105 



J.4* Depurar Actividades Sugar 

Introduccion 

No importa que tan cuidadoso seas, es bastante probable que tu 
Actividad no vaya a funcionar perfectamente la primera vez que la 
pruebes. Depurar una Actividad Sugar es un poco diferente a la 
depuracion de un programa independiente o autonomo. Cuando pruebas 
un programa independiente, tu solo debes ejecutar el programa en si. Si 
hay errores de sintaxis en el codigo puedes encontrar los mensajes de 
error de inmediato en la consola, y si se esta ejecutando en el IDE de 
Eric, la ultima linea de codigo sera seleccionada en el editor para que 
puedas corregiria y seguir adelante. 

Con Sugar es un poco diferente. Es el ambiente Sugar, no el de Eric, el 
que ejecuta el programa. Si hay errores de sintaxis en el codigo tu no 
puedes verlos de inmediato. En cambio, el icono de Actividad 
intermitente que se ve cuando tu Actividad se inicia, solo seguira 
parpadeando durante varios minutos y luego simplemente desaparecera 
y tu Actividad no se iniciara. La unica manera de encontrar el error que 
causo el problema sera utilizar la Actividad Registro. Si tu programa no 
tiene errores de sintaxis, pero tiene errores de logica, tu no seras capaz 
de dar un paso a traves de tu codigo con un depurador para 
encontrarlos. En su lugar, tendras que utilizar algun tipo de registro 
para rastrear a traves de el lo que esta sucediendo en el codigo y de 
nuevo utilizar la Actividad Registro para ver los mensajes de 
seguimiento. Ahora seria un buen momento para repetir algunos 
consejos que di antes: 

Haz una version independiente de tu programa 

Haga lo que haga tu Actividad, es casi seguro que el 80% de ella lo 
podria realizar un programa independiente, el cual es mucho menos 
tedioso para depurar. Si tu puedes pensar en una manera de hacer tu 
Actividad ejecutable, sea como una Actividad independiente o un 
programa Python autonomo, trata de hacerlo por todos los medios. 
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Usa PyLint, PyChecker, o PyFlakes 

Una de las ventajas de un lenguaje compilado como C sobre un lenguaje 
interpretado como Python es que el compilador realiza una 
comprobacion de sintaxis completa del codigo antes de convertirlo en 
lenguaje de maquina. Si hay errores de sintaxis el compilador te da 
mensajes de error informativos y se detiene la compilacion. Hay una 
utilidad llamada lint que los programadores de C pueden utilizar para 
hacer controles mas profundos que los que hace el compilador y 
encontrar cosas dudosas en el codigo. 

Python no tiene un compilador, sino que tiene varias utilidades (como la 
utilididad lint) que se pueden ejecutar en el codigo antes de probarlo. 
Estas utilidades son pyflakes, pychecker y pylint. Cualquier 
distribucion de Linux debe tener las tres disponibles. 

PyFlakes 

Aqui hay un ejempio del uso de PyFlakes: 

pyflakes minichat.py 

tninichat . py :25: ' COLOR_BUTTON_GREY' imported but unused 
minichat . py : 28 : 'XoColor' imported but unused 
tninichat . py: 29 : 'Palette' imported but unused 
minichat . py: 29 : ' Canvaslnvoker ' imported but unused 

PyFlakes parece hacer el menor control de los tres, pero encuentra 
errores como estos de arriba que podrian pasar desapercibidos al ojo 
humano . 

PyChecker 

Aqui esta PyChecker en accion: 

pychecker ReadEtextsActivity . py 

Processing ReadEtextsActivity... 

/usr/lib/python2. 5/site-packages/dbus/_dbus . py : 251: 
DeprecationWarning : The dbus_bindings module is not public 
API and will go away soon . 

Most uses of dbus_bindings are applications catching 
the exception dbus .dbus_bindings . DBusException . 
You should use dbus . DBusException instead (this is 
compatible with all dbus-python versions since 0.40.2). 

If you need additional public API, please contact 
the maintainers via <dbus@lists .f reedesktop . org>. 

import dbus . dbus_bindings as m 

Warnings . . . 
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/usr/lib/python2. 5/site- packages/sugar /activity /activity. py : 847 : 

Parameter (ps) not used 

/usr/lib/python2. 5/site -packages/sugar /activity /activity. py : 992: 

Parameter (event) not used 

/usr/lib/python2. 5/site -packages/sugar /activity /activity. py : 992: 

Parameter (widget) not used 

/usr/lib/python2. 5/site -packages/sugar /activity /activity. py : 996: 

Parameter (widget) not used 

/usr/lib/python2. 5/site -packages/sugar /graphics/window. py : 157 : 

No class attribute (_alert) found 

/usr/lib/python2. 5/site -packages /sugar /graphics/window. py : 164: 

Parameter (window) not used 

/usr/lib/python2. 5/site -packages/sugar /graphics/window. py : 188: 

Parameter (widget) not used 

/usr/lib/python2. 5/site -packages /sugar /graphics/window. py : 200: 

Parameter (event) not used 

/usr/lib/python2. 5/site -packages/sugar /graphics/window. py : 200: 

Parameter (widget) not used 

ReadEtextsActivity . py : 62 : Parameter (widget) not used 

4 errors suppressed, use -#/--limit to increase the number 
of errors displayed 

PyChecker no solo comprueba tu codigo, tambien comprueba el codigo 
que se importa, incluyendo el codigo de Sugar. 

PyLint 

Aqui esta PyLint, la mas completa de las tres: 

pylint ReadEtextsActivity . py 

No config file found, using default configuration 

************* Module ReadEtextsActivity 

C:177: Line too long (96/80) 

C: 1: Missing docstring 

C: 27: Operator not preceded by a space 

page=0 

A 

C: 27: Invalid name "page" (should match 

(([A-Z_][A-Z0-9_]*)|(__. *__))$) 

C: 30 : ReadEtextsActivity : Missing docstring 

C: 174: ReadEtextsActivity . read_file : Invalid name "zf" (should 

match [a-z_] [a-z0-9_]{2,30}$) 

W: 30 : ReadEtextsActivity : Method 'write_file' is abstract 

in class 'Activity' but is not overridden 

R: 30 : ReadEtextsActivity : Too many ancestors (12/7) 

W: 33 : ReadEtextsActivity . init : Using the global statement 

R: 62 : ReadEtextsActivity. keypress_cb : 
Too many return statements (7/6) 

C: 88 : ReadEtextsActivity . page_previous : Missing docstring 
W: 89 : ReadEtextsActivity. page_previous : 
Using the global statement 
C: 90 : ReadEtextsActivity. page_previous : 
Operator not preceded by a space 
page=page-l 
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A 

C: 91: ReadEtexts Activity. page_previous : 
Operator not preceded by a space 
if page < 0: page=0 

A 

C: 91: ReadEtextsActivity . page_previous : More than one 

statement on a single line 

C: 96 : ReadEtextsActivity . page_next : Missing docstring 

W: 97 : ReadEtextsActivity . page_next : Using the global 

statement 

C: 98 : ReadEtextsActivity . page_next : Operator not preceded 

by a space 

page=page+l 

A 

C: 99 : ReadEtextsActivity . page_next : More than one 

statement on a single line 

C: 104: ReadEtextsActivity . font_decrease : Missing docstring 

C: 112 : ReadEtextsActivity . font_increase : Missing docstring 

C:118 : ReadEtextsActivity . scroll_down : Missing docstring 

C:130 : ReadEtextsActivity . scroll_up : Missing docstring 

C:142 : ReadEtextsActivity . show_page: Missing docstring 

W: 143 : ReadEtextsActivity . show_page: Using global for 

'PAGE_SIZE' but no assigment is done 

W: 143 : ReadEtextsActivity . show_page: Using global for 

' current_word ' but no assigment is done 

W: 157 : ReadEtextsActivity. save_extracted_file : Redefining 

name 'zipfile' from outer scope (line 21) 

C: 163 : ReadEtextsActivity. save_extracted_file : Invalid 

name "f" (should match [a-z_] [a-z0-9_] {2, 30}$) 

W:171: ReadEtextsActivity . read_file: Using global 

for 'PAGE_SIZE' but no assigment is done 

C: 177 : ReadEtextsActivity . read_file: Invalid name 

"currentFileName" (should match [a-z_] [a-z0-9_] {2, 30}$) 

C:179 : ReadEtextsActivity . read_file: Invalid name 

"currentFileName" (should match [a-z_] [a-z0-9_] {2, 30}$) 

C: 197 : ReadEtextsActivity .ma ke_new_file name: Missing 

docstring 

R: 197 : ReadEtextsActivity . make_new_f ilename : Method could be 

a function 

R: 30 : ReadEtextsActivity : Too many public methods (350/20) 

W: 174: ReadEtextsActivity. read_file: Attribute 

' zf ' defined outside init 

W: 181: ReadEtextsActivity. read_file: Attribute 

'etext_file' defined outside init 

W: 175 : ReadEtextsActivity. read_file: Attribute 

' book_f iles ' defined outside init 

W: 182 : ReadEtextsActivity. read_file: Attribute 
'page_index' defined outside init 

. . . A bunch of tables appear here . . . 

Global evaluation 

Your code has been rated at 7.52/10 (previous run: 7.52/10) 



109 



Pylint es el mas duro con tu codigo y tu ego. No solo te informa acerca 
de los errores de sintaxis, te dice todos los errores que alguien podria 
encontrar en tu codigo. Esto incluye cuestiones de estilo que no van a 
afectar la forma como se ejecuta el codigo, sino que afectan el modo en 
que es legible por otros programadores. 



La Actividad Registro 



Al comenzar a probar tus Actividades, la Actividad Registro (Log) sera 
como tu segunda casa. Ella muestra una lista de archivos de registro en 
el panel de la izquierda y al seleccionar uno de ellos mostrara el 
contenido del archivo en el panel derecho. Cada vez que ejecutes tu 
Actividad, un nuevo archivo de registro se crea para ella, para que 
puedas comparar el registro que se obtuvo en esta ocasion con lo que 
tienes de ejecuciones anteriores. La barra de herramientas Edit (Editar) 
es especialmente util. Contiene un boton para mostrar el archivo de 
registro con "lineas ajustadas", es decir, justificadas (que no esta 
activada por defecto, pero probablemente deberias hacerlo). Tiene otro 
boton para copiar selecciones del registro en el portapapeles, que sera 
muy util si deseas mostrar mensajes del registro a otros 
desarrolladores. 



La barra de herramientas tiene un boton para borrar archivos de 
registro. Nunca he encontrado una razon para usarlo. Los archivos de 
registro se borran por si solos al reiniciar la XO. 




T^ /liome/jir-n/.sugar'/defsult/logi 

^^H n^t.nossnnanuals.MiniChat-l.log 

i]rg.lapt.(>p.Li>9-l.l03 

pfesenceservice.log 
I ^ell.log 

teiepacliy-salijit.lss 



boot 
bflot 

t)oo: 
boot 
boot 



Jog 
.log-20imi2Z 

.109-2010012'! 

.log-20ioozfle 

.log-2DlW215 



dmesg 

dmesg.oW 

lastlog 



activity, write_file is not 



+buddy+Buddy at B!!a566c5Sl> 

L265THM1. 936980 DEBUG fOOt 

iipplemented. 

L2667L454L.99736L OEBUQ root: data store. write 

L2667L4ML, 999744 DEBUG root: dbu5_helpers, update; Ijdb7f629- 

d2a2- 409f - 923e- 8c 12539251527, /hopne/j irV- &ugar/*f ault/ 

data/ LdbTf 629 ■ d202 ■ 409f ■ 923e ■ Oc L2SS920b27 . doc , tdbu s . St ring 

[u ■activity_id' ] : dbus.ByteArray 

1 '4c222799748a56b24eSe29c7dec5S5f6&e9f512c ' , 

var-larit_level=L) , dbus-Stfinglu 'title_5et_by_user' ) : 
dbus,EyteArray( 'Q' , variant_level=L) , dbus.5tring(u 'uid' ) : 
dbu5.6yteArray[ ' Ldb7f629-d2e2-4e9f-Si23e-0cL2a892eb27' , 
variant_level=L] , dbus.St ring lu 'title' ) : dbus.ByteArray 
[Ini chat Activity, variant_level=l), dbus-String 
'timestarrp' ) : L2667L454I, dbu S.St ring (u 'activity ') : 
dbus.ByteArrayl 'net.flossmanuals.MiniChat' , 
variant_level=i) , dbus.Stringlu ' share- scope' ) ; 
|dbu &. By teAr ray ( 'public, variant_level=l) , dbus. String 
[u'keep']: dbus.ByteArray[ 'Q' , variant level=L] , dbus. string 
[u' icon -color'] ■ dbus.ByteArrayl ■#CiOAaFF,#FF2B34' , 
|variant_level=l] , dbus.Stringlu 'mtiine' ) : 
' 2015- 02- 21.T51; 139: 51- 999242', dbUS .String[U 'tsrsview' ) ; 
' '^omitted> ' , dbus.string(u 'mime_type' ) : dbus.ByteArray 
f ' text/plain ■ , variant level-L) >, True 
L2667L4M2, 640513 DEBUG root: Written object LdbTf 629 - 
|d292-4B9f-923e-0cl253925b27 to the datastore. 
1266714542. 117447 DEBUG root: Activity. _save_cb 
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Esto es lo que la Actividad Registro muestra cuando detecta un error de 
sintaxis en el codigo: 




■^ jJiome/jim^sugarAlefauit/logs 
datastore.lcg 
ne : , flossmanuals , Minichi 
org.lapCapj^alyze-l.log 
«r^.lap(et>.Li>g-l.loj 
«rgj9pte|>.LI>C(-2.l09 
pfesenceseruiceJog 
shietlkg 

^^^^^^K.slpc .speSk- l.(og 






/usr/'lib/python2.5/site-packages/sugar/uti'l.py;25; 
DepnecatlanMamlng: the sha module is deprecatedj use the hashllb 
Tcdule instead 

inport sha 
Tracebatik (nwst recent call last); 
File "/usr/bin/sugar'Activity", line 21, in <iiQdule^ 

main ,main [) 
File "/u5r/lib/python2,6/5ite-package5/5ugar/activity/main .py"j 
line 112, in nfiain 

module = inport [module_name) 

File "/u 5 r/sha re/ sugar/cictiij'ities/Speak. activity/activity, py" J 
line 59j in <niodule> 
import voi<:e 
File "/usr/ sha re/ sugar/activities/Speak. activity/voice, py", line 
|104 

a.lowerO) 



as = re. split t rM''a-2]l + ', 




^^^yntaxErnor: invalid syntax 
■Gi266716031. 992572 DEeua root; 



_c leanu p_tenp_f i le s 



Logging (registro) 

Sin lugar a dudas la tecnica mas antigua de depuracion debe ser la 
declaracion de un simple print. Si tu tienes un programa en ejecucion 
que se porta mal por los errores de logica y no puedes recorrer el codigo 
en un depurador para averiguar lo que esta sucediendo, puedes poner 
declaraciones print en tu codigo. Por ejempio, si no estas seguro si un 
metodo Mega a ser ejecutado, puedes poner una declaracion como esta 
como la primer linea del metodo: 

def ini_metodo( ) : 

print 'nii_iiietodo( ) inlcla' 

Tambien puedes incluir datos en las declaraciones de print. 
Supongamos que necesitas saber cuantas veces se ejecuta un bucle. Tu 
puedes hacer esto: 

while contador < TAMANIO_PAGINA: 

linea = self . archivo_texto . readline( ) 

texto_etiqueta = texto_etiqueta + unicode(linea, 'iso-8859 

contador = contador + 1 

print 'contador=' , contador 

La salida de estos print se puede ver en la Actividad Registro. Cuando 
hayas terminado de depurar el programa deberias eliminar estas 
declaraciones. 
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Un viejo libro de programacion que lei una vez, aconsejaba dejar las 
declaraciones print en el programa terminado. Los autores consideran 
que el uso de estas declaraciones para la depuracion y la posterior 
eliminacion de errores se parece un poco a llevar un paracaidas cuando 
el avion esta en tierra y quitarselo cuando esta en el aire. Si el programa 
esta afuera en el mundo y tiene problemas te gustaria tener esas 
declaraciones en el codigo para que puedan ayudar al usuario y a ti 
mismo a descubrir lo que esta pasando. Por otro lado, las declaraciones 
de print no son gratuitas. Ellas se toman el tiempo para correr y llenan 
los archivos de registro de basura. Lo que necesitamos son print que 
uno pueda prender y apagar. 

La forma en que se puede hacerlo es con Python Standard Logging. La 

forma utilizada por la mayoria de las Actividades se parece a esto: 

self._logger = logging . getLogger( ' read-etexts-activity ' ) 

Estas declaraciones pueden ir en el metodo init () de su actividad. 

Cada vez que quieras hacer un print puedes hacer en su lugar: 

def _shared_cb(self , activity): 

self ._logger .debug( 'Mi actividad fue compartida') 

self . iniciando = True 
self ._sharing_setup( ) 

self ._logger . debug( ' Esta es mi actividad: haciendo un tubo...' 
id = self .tubes_chan[telepathy.CHANNEL_TYPE_TUBES] A 
OfferDBusTube(SERVICE, {}) 

def _sharing_setup(self ) : 

if self ._shared_activity is None: 
self ._logger. error ( 

'Failed coitipartir o unirse a la actividad') 

return 

Ten en cuenta que hay dos tipos de registro aqui: de "depuracion" y de 
"error" (debug y error respectivamente). Estos son niveles de error. 
Cada sentencia tiene uno, y controlan que declaraciones de control se 
ejecutan y cuales son ignoradas. Hay varios niveles de registro de 
errores, desde la severidad mas baja a la mas alta: 

self ._logger . debug( "mensaje de depuracion") 
self ._logger . info( "mensaje de informacion" ) 
self ._logger .warn( "mensaje de advertencia") 
self ._logger . error( "mensaje de errorr") 
self. _logger. critical ("mensaje critico") 

Cuando estableces el nivel de error en tu programa a uno de estos 
valores, se reciben mensajes con ese nivel y mas alto. Tu puedes ajustar 
el nivel en el codigo del programa asi: 

self. _logger.setLevel(logging. DEBUG) 
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Tambien puedes establecer el nivel de registro fuera del codigo de tu 
programa con una variable de entorno. Por ejempio, en la version de 
Sugar 0.82 e inferiores, puedes empezar un emulador de Sugar de la 
siguiente manera: 

SUGAR_LOGGER_LEVEL=debug sugar -emulator 

Tu puedes hacer lo mismo en la version 0.84 y posteriores, pero hay una 
manera mas conveniente. Edita el archivo -/.sugar/debug y 
descomenta la linea que establece el SUGAR_LOGGER_LEVEL. Sea cual 
sea el valor que tiene SUGAR_LOGGER_LEVEL en -/.sugar/debug 

anulara el establecido por la variable de entorno, por lo tanto, hay que 
cambiar la configuracion en el archivo o utilizar la variable de entorno, 
pero no hagas ambas. 



La Actividad Analyze 



Otra Actividad que utilizaras en algun momento es Analyze. Esta 
Actividad es mas probable que la utilices para la depuracion de Sugar en 
SI mismo que para depurar tu Actividad. Si por ejempio, el entorno de 
prueba de la colaboracion no parece estar funcionando, esta Actividad 
podria ayudarte a ti o a alguien mas a encontrar por que. 

No tengo mucho que decir acerca de esta Actividad aqui, pero por lo 
menos tu debes saber que existe. 




INFO 
INFO 
INFO 
INFO 
INFO 
INFO 



.M 



Actiuicy /orgilafKop/sugar/PresencejAcciuitiesA eiriicted NewchannelC.../Mucchannelfl') ormencioned the clia 
ActJuJty/flrg/^aptop/sugarJPresence/Actriuities/l emitted Newchanne!["..VMuc"Iuibe5C:hannell''J ormentiQiied tl 
Activity /org^aptopVSugar;iPresence/Acl:ivitJes/l emitted auddyjoinedf"..7keyitl/7dbce[}7d43a51]504ae5[>r33! 
< Buddy /orgflaptopjSugarjPresence/Buddi es^e^nii/TdlJce D 7d43 a 5b 504B&5 D f33 5SB5BJ332B99C 9e77 > .Get Prope 
Buddy /ofg/l5ptop/sugar/PnesenceyBuddies/keyidy7dtice0Td43a5b5O4Be50f335BB5B2222Bg9cgeT7 emitted Acti 
Buddy /flrg/1aptopy5Ljgar/PriesenceyEuddies/keyid/7dbce0Td4^a5b5(M3e50f335BB5B2232BEigc3e77 emitted Tfele 

ActEvJties: 

4c222799748a55b24e3e2St7d0c585fS0e9f512c #FF2B34.#0OA0FF net.flossmanuals.MimChit Mh 




...*eynl7[lbcetl7d43a5b5043eS0f33533532222399c9e77 580 bytes, stial TdbceO J d« a 5b 5043e50f33 533532222399 
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1. Traducido Alan Aguiar, Uruguay- 
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Temas Avanzados 

15. Hacer Actividades compartidas 

16. Agregar texto hablado 

17. Jugar con el Journal 

18. Construir Actividades con Pygame 

19. Hacer nuevas barras de herramientas 
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J.!3« Hacer Actividades compartidas 

Introduccion 

Una de las cualidades distintivas de Sugar es que varias Actividades 
tienen la capacidad de ser utilizadas por mas de una persona al mismo 
tiempo. Mas y mas computadoras estan siendo utilizadas como medio de 
comunicacion.Los mas recientes juegos de computadora no solo ponen 
al jugador en contra de una maquina; sino que construyen un mundo en 
el que los jugadores compiten entre si. Websites 

comoFacebookincrementan su popularidad porque dan a las personas 
la posibilidad de interactuar e incluso jugar juegos entre si. Entonces, es 
natural que un software educativo apoye este tipo de interacciones. 

Tengo una sobrina que es miembro entusiasta del sitio web "El Club del 
Pinguino"creado por Disney. Cuando le di Sugar on a Stick Blueberry 
como regalo de Navidad le mostre la vista Vecindario (Neighborhood en 
ingles) y le dije que Sugarpermitia que toda su computadora se 
comportara como el Club del Pinguino. Ellapensoque era una idea genial. 
Me gusta mencionarlo. 

Ejecutar Sugar como mas de un usuario 

Antes de empezar a escribir unaporciondecodigo es necesario pensar 
como se realizara la prueba de estas Actividades. En el caso de una 
Actividad compartida es razonable pensar que es necesario tener mas de 
una computadora para realizar tests o pruebas sobre dicha Actividad, 
pero los disehadores de Sugar tomaron en cuenta que las Actividades 
serian compartidas y desarrollaron medios por los cuales se pueden 
probar las Actividades compartidas utilizando solo una computadora. 
Estosmetodoshan ido evolucionando, por lo que existen ligeras 
variaciones en como probar dependiendo de la version de Sugar que se 
este utilizando. La primera cosa que se debe saber es como correr 
multiples instancias de Sugar como usuarios diferentes. 

Fedora 10 (Sugar .82) 

En Sugar .82 existe una manera practica para ejecutarmultiplescopias 
del emulador Sugar y tener cada instancia como un usuario diferente, 
sin tener que haber iniciado sesion en la maquina Linux con mas de un 
usuario. En la linea de comando para cada usuario adicional que se 
quiera ejecutar es necesario ahadir una variable de entorno 
SUGARPROFILE de la siguiente forma: 

SUGAR_PROFILE=austen sugar -emulator 
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Cuando haces esto el emulador de Sugar creara un directorio llamado 
austen bajo -/.sugar para almacenarinformaciondel perfil en dicho 
directorio, etc. Se te solicitara introducir un nombre y seleccionar un 
color para el icono. Cada vez que arranques usando elSUGAR_PROFILE 
deausten, seras ese usuario. Si lanzas el emulador sin utilizar un 
SUGAR_PROFILE, seras el usuario regular que configuraste previamente. 

Fedora 11 (Sugar .84) 

A pesar de lo practico de usar el SUGAR_PROFILE, los desarrolladores de 
Sugar decidieron que tenia limitaciones y por lo tanto dejo funcionar en 
la version .84 y posteriores. Con Sugar .84 y superiores es necesario 
crear un usuario Linux adicional y ejecutar el emulador Sugar como dos 
usuarios Linux independientes. En el entorno GNOME existe una 
opcionUsuarios y Grupos (Users and Groups) en el submenu 
Administracion (Administration) del menu Sistema (System)desde 
donde es posible configurar un segundo usuario. Antes se te solicitara 
que ingreses la contrasena de administrador que has creado cuando has 
configurado inicialmente el entorno Linux con el que trabajas. 

Crear el segundo usuario es bastante simple, pero <i.c6mo se consigue 
tener dos usuarios diferentes registrados al mismo tiempo? De hecho es 
bastante simple. Es necesario que abras una terminal e ingreses lo 
siguiente: 

ssh -XY jausten@localhost 

Vemos que "jausten" es el user_id del segundo usuario. Se hara una 
consulta para verificar la confiabilidad de la computadora "localhost". 
"localhost" significa que utilizaras los mecanismos de red para iniciar 
una nueva sesion dentro la misma computadora, entonces es seguro 
contestar que si (yes). Entonces se te pedira introducir su contrasena 
(password), y desde ese momento todo lo que realices desde esa 
terminal pertenecera al usuario con has iniciado la sesion. Puedes iniciar 
el emulador de Sugar desde esta terminal y la primera vez te pedira un 
nombre y color del icono. 

sugar-jhbuild 

Con sugar-jhbuild (la ultima version de Sugar) las cosas nuevamente 
cambian un poquitin. Debes usar el metodo de inicio de sesion como 
multiples usuarios Linux tal como se hace para le version .84, pero no se 
te preguntara ningun nombre de usuario. En su lugar Sugar utilizara el 
nombre de usuario con el que esta corriendo el sistema. No podras 
cambiar el nombre de usuario, pero si podras cambiar el color del icono 
como siempre. 
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Necesitas una instalacion independiente de sugar-jhbuild para cada 
usuario. Estas instalaciones adicionales seran bastante rapidas puesto 
que se instalaron todas las dependencias la primera vez. 

Conectar con otros usuarios 

Sugar utiliza un software llamado Telepathy, el cual implementa un 
protocolo de intercambio de mensajes instantaneo llamado XMPP 
(Extended Messaging and Presence Protocol). Este protocolo solia 
llamarse Jabber. En esencia Telepathy permite incrustar un cliente de 
mensajeria instantanea dentro de tu Actividad (Activity). Puedes utilizar 
este recurso para enviar mensajes de usuario a usuario, ejecutar 
metodos remotamente e incluso para realizar transferencia de archivos. 

De hecho existen dos formas para que los usuarios de Sugar puedan 
interactuar en una red: 

Salut 

Si dos computadoras estan conectadas en el mismo segmento de una 
red, las mismas deberian ser capaces de encontrarse y compartir 
Actividades. Si tienes una red domestica donde todo el mundo utiliza el 
mismo router puedes compartir con otros en esa red. A este tipo de 
conexion se lo suele llamar Link-Local XMPP. El software Telepathy que 
hace esto posible se conoce como Salut. 

Las laptops XO cuentan con software y hardware especial que les 
permite soportar las redes Malla (Mesh Networking), donde las XO que 
estan proximas pueden automaticamente iniciar una red malla sin 
necesidad de un router. Para Sugar mientres estes conectado no 
importa el tipo de conexion tengas. Cableada o inalambrica (llamada 
tambien por radio o wireless), Malla o no, todas ellas funcionan de la 
misma forma. 
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El servidor Jabber 

Otra forma de conectarse a otros usuarios y sus Actividades es a traves 
del uso de un servidor Jabber. La ventaja de usar un servidor Jabber es 
que es posible conectar y compartir Actividades con personas fuera de la 
red local. Estas personas incluso podrian estar al otro lado del mundo. 
Jabber permite que Actividades en diferentes redes se conecten entre si, 
aun cuando estas redes se encuentren protegidas por un muro de fuego 
(firewall en ingles - en el mundo informatico el termino muro de fuego 
se utiliza para referirse a un software de proteccion de intrusos sobre la 
red). La parte de Telepathy que trabaja con un Seridor Jabber se llama 
Gabble. 

En general deberias usar Salut para testear tus aplicaciones si es 
posible. Esto simplifica el testeo y no utiliza los recursos de un Servidor 
Jabber. 

Realmente no es importante si tu Actividad se conecta con otros usando 
Gabble o Salut. De hecho, la Actividad no tiene idea que esta utilizando. 
Estos detalles se encuentran escondidos para la Actividad y es directa 
responsabilidad de Telepathy. Cualquier Actividad que trabaja con Salut 
trabajara tambien con Gabble y viceversa. 

Para configurar el emulador-sugar para que utilice Salut ve al panel de 
control de Sugar: 
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Q Regis 



En Sugar .82 esta opcion de menu se llama Panel de Control (Control 
Panel). En versiones mas recientes se llama My Settings (Mis 
parametros u opciones) 



120 




Haz die en el icono de la red (Network). 
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wireless 



Turn off the wireless radio to save battery life 

I I Radio 

Discard network history if you have 
trouble connecting to the network 



Discard network history 



Mesh 



Server: 



El campo Servidor en esta pantalla debe permanecer vacio para usar 
Salut. Puedes usar la tecia de borrar (backspace) para borrar cualquier 
entrada en este campo. 

Debes seguir todos estos pasos para cada usuario Sugar que vaya a ser 
parte del test de la Actividad compartida. 

Si por alguna razon deseas testear tu Actividad utilizando un servidor 
Jabber, en el Wiki de OLPC se mantiene una lista de servidores publicos 
disponibles en http://wiki.laptop.org/go/CommunityJabber_Servers 

Una vez que tienes configurado sea Salut o un Servidor Jabber en ambas 
instancias de Sugar que ejecutes, debes ir a la vista de Vecindario 
(Neighborhood) de ambas maquinas para ver si entre ellas fueron 
capaces de detectarse, y quiza puedas intentar utilizar la actividad Chat 
entre ellas. Si tienes todo esto funcionando estas listo para intentar 
programar una Actividad compartida. 
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La Actividad MiniChat 

Tal como tomamos la Actividad Read Etexts y la analizamos al detalle, 
vamos a hacer lo mismo con la Actividad Chat para crear una nueva 
Actividad a la que llamaremos MiniChat. La Actividad real Chat (Chat 
Activity) tiene ciertas caracteristicas que no necesitamos para demostrar 
la mensajeria de una Actividad compartida: 

• Tiene la habilidad de cargar su codigo en Pippy para su visualizacion. 
Esta es una cualidad que supuestamente tienen todas las 
actividades de las XO, pero Chat es una de las pocas que lo 
implementan. Personalmente, si quiero ver el codigo de una 
Actividad prefiero ir directamente a git.sugarlabs.org donde tengo la 
posibilidad de ver tanto el codigo actual como versiones anteriores. 

• Chat puede mantener una conexion de uno a uno con un cliente 
convencional XMPP. Esto puede ser util para el Chat pero no 
necesariamente util o deseable para la mayoria de las Actividades 
compartidas. 

• Si incluyes una URL en un mensaje del Chat, la interfaz de usuario te 
permite hacer die en la URL para hacer una entrada en el Diario 
(Journal) para dicha URL. Entonces puedes usar el Diario (Journal) 
para abrir la URL con la Actividad Browse (Navegar). (Esto es 
necesario porque las Actividades no pueden lanzarse unas a otras). 
Es genial, pero no es necesario para demostrar como se hace una 
Actividad compartida. 

• La sesion de chat se guarda en el Diario (Journal). Cuando retomas 
el Chat desde el Diario (Journal) restaura los mensajes desde tu 
sesion previa en la interfaz de usuario. Nosotros ya sabemos como 
guardar cosas en el Diario y tambien como restaurar cosas desde el 
Diario, por lo tanto el MiniChat no hara esto. 

El codigo resultante es aproximadamente la mitad de largo que el 
original. Tambien hice algunos otros cambios: 

• El campo de entrada esta arriba de los mensajes del chat en lugar de 
abajo. Esto permite tomar capturas de pantalla parciales de la 
Actividad en accion mas facilmente. 

• He eliminado la barra de herramientas (toolbar) del nuevo estilo y la 
cambie por una barra de herramientas del viejo estilo. Esto me 
permite testear la Actividad en Fedora 10 y 11 la cual no soporta las 
nuevas barras de herramientas (toolbars). 

• Tome la clase TextChannelWrapper y la puse en un archivo propio 
diferente. Hice esto porque la clase parecia util para otros proyectos. 
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El codigo y todos los archives requeridos para la Actividad MiniChat 
estan en el directorio MiniChat del repositorio Git. Para ejecutarlo 
necesitas correr: 

. /setup. py dev 

en el proyecto para dejarlo listo para el test. La activity.info se ve asi 

[Activity] 

name = Mini Chat 

service_name = net . flossmanuals .MiniChat 

icon = chat 

exec = sugar-activity minichat . MiniChat 

show_launcher = yes 

activity_version = 1 

license = GPLv2+ 

Este es el codigo para textcliannel.py: 

import logging 

from telepathy . client import Connection, Channel 
from telepathy . interfaces import ( 

CHANNEL_INTERFACE, CHANNEL_INTERFACE_GROUP, 

CHANNEL_TYPE_TEXT, CONN_INTERFACE_ALIASING) 
from telepathy . constants import ( 

CHANNEL_GROUP_FLAG_CHANNEL_SPECIFIC_HANDLES, 

CHANNEL_TEXT_MESSAGE_TYPE_NORMAL) 

class TextChannelWrapper(object ) : 

"""Wrap a telepathy Text Channel to make 
usage simpler.""" 

def init (self, text_chan, conn): 

"""Connect to the text channel""" 

self ._activity_cb = None 

self ._activity_close_cb = None 

self ._text_chan = text_chan 

self._conn = conn 

self._logger = logging . getLogger( 

' minichat - act ivity.TextChannelWrapper ' ) 
self ._signal_matches = [] 
m = self ._text_chan[CHANNEL_INTERFACE] .\ 
connect_to_signal( 
'Closed', self ._closed_cb) 
self ._signal_matches . append (m) 

def send(self, text): 

"""Send text over the Telepathy text channel.""" 
# XXX Implement CHANNEL_TEXT_MESSAGE_TYPE_ACTION 
if self ._text_chan is not None: 

self ._text_chan[CHANNEL_TYPE_TEXT] .Send( 

CHANNEL_TEXT_MESSAGE_TYPE_NORMAL, text) 

def close(self ) : 

"""Close the text channel.""" 

self ._logger . debug( ' Closing text channel') 

try: 

self ._text_chan[CHANNEL_INTERFACE] .Close( ) 
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except : 

self. _logger.debug( 'Channel disappeared! ') 
self ._closed_cb( ) 

def _closed_cb(self ) : 

"""Clean up text channel.""" 

self ._logger .debug( 'Text channel closed.') 

for match in self ._signal_matches : 

match . remove( ) 
self ._signal_matches = [] 
self ._text_chan = None 
if self ._activity_close_cb is not None: 

self ._activity_close_cb( ) 

def set_received_callback(self , callback): 

"""Connect the function callback to the signal. 

callback -- callback function taking buddy 
and text args 

ri t[ n 

if self ._text_chan is None: 

return 
self ._activity_cb = callback 
m = self ._text_chan[CHANNEL_TYPE_TEXT] .\ 

connect_to_signal( 

'Received', self ._received_cb) 
self ._signal_matches . append (m) 

def handle_pending_messages(self ) : 

"""Get pending messages and show them as 
received . """ 

for id, timestamp, sender, type, flags, text \ 
in self ._text_chan[ 

CHANNEL_TYPE_TEXT] . ListPendingMessages ( 
False) : 

self ._received_cb(id, timestamp, sender, 
type, flags, text) 

def _received_cb(self , id, timestamp, sender, 
type, flags, text) : 
"""Handle received text from the text channel. 

Converts sender to a Buddy. 

Calls self ._activity_cb which is a callback 

to the activity. 

ri t[ M 

if self ._activity_cb: 

buddy = self ._get_buddy(sender ) 
self ._activity_cb(buddy, text) 
self._text_chan[ 

CHANNEL_TYPE_TEXT] . 

AcknowledgePendingMessages( [id] ) 
else: 

self._logger.debug( 

'Throwing received message on the floor' 

' since there is no callback connected. See ' 

' set_received_callback ' ) 

def set_closed_callback(self , callback): 
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"""Connect a callback for when the text channel 
is closed. 

callback -- callback function taking no args 



self ._activity_close_cb = callback 

def _get_buddy(self , cs_handle): 

"""Get a Buddy from a (possibly channel-specific) 
handle.""" 

# XXX This will be made redundant once Presence 

# Service provides buddy resolution 

from sugar . presence import presenceservice 

# Get the Presence Service 

pservice = presenceservice . get_instance( ) 

# Get the Telepathy Connection 
tp_name, tp_path = \ 

pservice . get_preferred_connection( ) 
conn = Connection( tp_name, tp_path) 
group = self ._text_chan[CHANNEL_INTERFACE_GROUP] 
my_csh = group. GetSelf Handle( ) 
if my_csh == cs_handle: 

handle = conn .GetSelfHandle( ) 
elif group . GetGroupFlags( ) & \ 

CHANNEL_GROUP_FLAG_CHANNEL_SPECIFIC_HANDLES: 

handle = group .GetHandleOwners( [cs_handle] ) [0] 
else : 

handle = cs_handle 

# XXX: deal with failure to get the handle owner 
assert handle != 

return pservice .get_buddy_by_telepathy_handle( 
tp_name, tp_path, handle) 

Y aqui esta el codigo para minichat.py: 

from gettext import gettext as _ 

import hippo 

import gtk 

import pango 

import logging 

from sugar . activity . activity import (Activity, 

ActivityToolbox, SCOPE_PRIVATE) 
from sugar . graphics . alert import NotifyAlert 
from sugar . graphics . style import (Color, COLOR_BLACK, 

COLOR_WHITE, COLOR_BUTTON_GREY, FONT_BOLD, 

FONT_NORMAL) 
from sugar . graphics . roundbox import CanvasRoundBox 
from sugar . graphics .xocolor import XoColor 
from sugar . graphics . palette import Palette, Canvaslnvoker 

from textchannel import TextChannelWrapper 

logger = logging . getLogger( 'minichat-activity ' ) 

class MiniChat (Activity) : 

def init (self, handle): 
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Activity. init (self, handle) 

root = self .make_root( ) 
self. set_canvas( root) 
root . show_all( ) 
self .entry .grab_focus( ) 

toolbox = ActivityToolbox(self ) 

activity_toolbar = toolbox. get_activity_toolbar ( ) 
activity_toolbar . keep . props .visible = False 
self. set_toolbox( tool box) 
toolbox. show( ) 

self. owner = self ._pservice . get_owner( ) 

# Auto vs manual scrolling: 
self ._scroll_auto = True 
self ._scroll_value = 0.0 

# Track last message, to combine several 

# messages: 

self ._last_msg = None 

self ._last_msg_sender = None 

self . text_channel = None 

if self ._shared_activity : 

# we are joining the activity 
self.connect( 'joined' , self ._joined_cb) 
if self . get_shared( ) : 

# we have already joined 
self ._joined_cb( ) 

else: 

# we are creating the activity 

if not self . metadata or self . metadata. get ( 
' share-scope ' , 
SCOPE_PRIVATE) == SCOPE_PRIVATE : 

# if we are in private session 
self ._alert(_( 'Off-line' ), 

_( 'Share, or invite someone.')) 
self.connect( 'shared' , self ._s hare d_cb) 

def _shared_cb(self , activity): 

logger . debug( ' Chat was shared') 
self ._setup( ) 

def _setup(self ) : 

self . text_channel = TextChannelWrapper( 

self ._shared_activity . telepathy_text_chan, 

self ._shared_activity . telepathy_conn) 
self. text_channel . set_received_callback( 

self ._received_cb) 
self ._alert(_( 'On-line' ), _( 'Connected ') ) 
self ._shared_activity . connect( 'buddy-joined' , 

self ._buddy_joined_cb) 
self ._shared_activity .con nee t( 'buddy-left', 

self ._buddy_lef t_cb) 
self. entry. set _sensitive(True) 
self .entry .grab_focus( ) 

def _joined_cb(self , activity): 

"""Joined a shared activity.""" 
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if not self ._shared_activity : 
return 

logger . debug( ' Joined a shared chat') 

for buddy in \ 

self ._shared_activity . get_joined_buddies( ) : 
self ._buddy_already_exists( buddy) 

self ._setup( ) 

def _received_cb(self , buddy, text): 

"""Show message that was received.""" 
if buddy: 

nick = buddy . props . nick 
else : 

nick = '???' 
logger . debug( 

'Received message from %s : %s ' , nick, text) 
self .add_text(buddy, text) 

def _alert(self, title, text=None) : 
alert = NotifyAlert( timeout=5) 
alert . props . title = title 
alert . props .msg = text 
self . add_alert (alert ) 

alert. connect('response', self ._alert_cancel_cb) 
alert . show( ) 

def _alert_cancel_cb(self , alert, response_id) : 
self . remove_alert (alert ) 

def _buddy_joined_cb (self, activity, buddy): 
"""Show a buddy who joined""" 
if buddy == self. owner: 

return 
if buddy: 

nick = buddy . props . nick 
else : 

nick = '???' 
self .add_text( buddy, buddy. props. nick+' 

'+_( 'joined the chat'), 

status_message=True) 

def _buddy_lef t_cb (self, activity, buddy): 
"""Show a buddy who joined""" 
if buddy == self. owner: 

return 
if buddy: 

nick = buddy . props . nick 
else : 

nick = '???' 
self .add_text( buddy, buddy. props. nick+' 

'+_( 'left the chat' ), 

status_message=True) 

def _buddy_already_exists(self , buddy): 

"""Show a buddy already in the chat.""" 
if buddy == self. owner: 

return 
if buddy: 

nick = buddy . props . nick 
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else: 

nick = '???' 
self .ad d_text( buddy, buddy. props. nick+ 

' '+_( 'is here' ), 

status_message=True) 

def make_root (self ) : 

conversation = hippo. CanvasBox( 

spacing=0, 

background_color=COLOR_WHITE.get_int( ) ) 
self .conversation = conversation 

entry = gtk.Entry() 

entry. modify_bg(gtk.STATE_INSENSITIVE, 

COLOR_WHITE. get_gdk_color( ) ) 
entry. modify_base(gtk.STATE_INSENSITIVE, 

COLOR_WHITE. get_gdk_color( ) ) 
entry. set_sensitive( False) 
entry. connect( ' activate ' , 

self . entry_activate_cb) 
self. entry = entry 

hbox = gtk.HBoxO 
hbox.add(entry) 

sw = hippo . CanvasScrollbars( ) 
SW.set_policy( hippo. ORIENTATION_HORIZONTAL, 

hippo . SCROLLBAR_NEVER) 
sw.set_root(conversation) 
self . scrolled_window = sw 

vadj = self . scrolled_window. props .widget .\ 

ge t_vad just men t( ) 
vadj. connect ('changed', self.rescroll) 
vadj . connect ( 'value-changed', 

self . scroll_value_changed_cb) 

canvas = hippo .Canvas( ) 
canvas . set_root(sw) 

box = gtk. VBox(homogeneous=False) 
box . pack_s tart (hbox, expand=False) 
box . pack_s tart (canvas) 

return box 

def rescroll(self , adj, scroll=None) : 

"""Scroll the chat window to the bottom""" 
if self ._scroll_auto: 

adj . set_value(adj . upper -adj . page_size) 
self ._scroll_value = adj . get_value( ) 

def scroll_value_changed_cb(self , adj, scroll=None) : 
"""Turn auto scrolling on or off. 

If the user scrolled up, turn it off. 

If the user scrolled to the bottom, turn it back on, 

ri i[ H 

if adj . get_value( ) < self ._scroll_value: 
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self ._scroll_auto = False 
elif adj . get_value( ) == adj . upper-adj . page_size: 
self ._scroll_auto = True 

def add_text(self , buddy, text, status_message=False) 
"""Display text on screen, with name and colors. 

buddy -- buddy object 

text -- string, what the buddy said 

status_message -- boolean 

False: show what buddy said 

True: show what buddy did 



hippo layout: 



rb 



+ name_vbox+ + msg_vbox + 

I 



nick : 



+- -msg_hbox- 

I text 

+ . 

+ - -msg_hbox- 

I text 

+ . 



if buddy 
nick 
colo 
try 



= buddy . props . nick 
r = buddy . props . color 



\ 



( 



color_stroke_html, color_fill_html 
color . split( ' , ' ) 
except ValueError: 

color_stroke_html, color_fill_html 
'#000000', '#888888') 
# Select text color based on fill color: 
color_fill_rgba = Color( 

color_f ill_html) . get_rgba( ) 
color_fill_gray = (color_fill_rgba[0] + 

color_f ill_rgba[l] + 

color_fill_rgba[2] )/3 
color_stroke = Color( 

color_stroke_html) .get_int( ) 
color_fill = Color(color_fill_html) . get_int ( ) 
if color_fill_gray < 0.5: 

text_color = COLOR_WHITE. get_int( ) 
else : 



else : 



text_color = COLOR_BLACK. get_int( ) 



nick = '???' 

# XXX: should be ' ' but leave for debugging 

color_stroke = COLOR_BLACK. get_int( ) 

color_fill = COLOR_WHITE.get_int( ) 

text_color = COLOR_BLACK. get_int ( ) 

color = '#000000, #FFFFFF' 

# Check for Right-To-Left languages: 
if pango . f ind_base_dir(nick, -1) == \ 
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pango . DIRECTION_RTL : 
lang_rtl = True 
else: 

lang_rtl = False 

# Check if new message box or add text to previous: 
new_msg = True 

if self ._last_msg_sender : 
if not status_message : 

if buddy == self ._last_msg_sender : 
# Add text to previous message 
new_msg = False 

if not new_msg : 

rb = self ._last_msg 

msg_vbox = rb . get_children( ) [1] 

msg_hbox = hippo. CanvasBox( 

orientation=hippo.ORIENTATION_HORIZONTAL) 
msg_vbox.append(msg_hbox) 
else: 

rb = CanvasRoundBox( 

background_color=color_f ill, 

border_color=color_stroke, 

padding=4) 
rb . props . border_color = color_stroke 
self ._last_msg = rb 
self ._last_msg_sender = buddy 
if not status_message : 

name = hippo. CanvasText (text = nick+ ' : ', 
color=text_color, 
font_desc=FONT_BOLD. get_pango_desc( ) ) 

name_vbox = hippo .CanvasBox( 

orientation=hippo . ORIENTATION_VERTICAL) 

name_vbox .append(name) 

rb . append (name_vbox) 
msg_vbox = hippo. CanvasBox( 

orientation=hippo.ORIENTATION_VERTICAL) 
rb. append (msg_vbox) 
msg_hbox = hippo. CanvasBox( 

orientation=hippo.ORIENTATION_HORIZONTAL) 
msg_vbox.append(msg_hbox) 

if status_message : 

self ._last_msg_sender = None 

if text: 

message = hippo . CanvasText( 

text=text, 

size_mode=hippo . CANVAS_SIZE_WRAP_WORD, 

color=text_color, 

font_desc=FONT_NORMAL . get_pango_desc( ) , 

xalign=hippo.ALIGNMENT_START) 
msg_h box. append (message) 

# Order of boxes for RTL languages: 
if lang_rtl: 

msg_hbox. reverse ( ) 
if new_msg : 

rb . reverse( ) 
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if new_msg: 

box = hippo .CanvasBox(padding=2) 

box.append( rb) 

self. con versation.append(box) 

def entry_activate_cb(self , entry): 
text = entry . props . text 
logger . debug( ' Entry : %s ' % text) 
if text: 

self . add_text (self . owner, text) 
entry . props . text = '' 
if self . text_channel: 

self. text _ch an nel.send( text) 
else : 

logger . debug( 

'Tried to send message but text ' 
'channel not connected.') 

Y asi es como se ve la Actividad en accion: 



^^^ 



Mini chat Activity 




( )ane Austen is here 

fames: Hello Jane 

I How are you? 




Mane Austen: As well as can be expected. And you? 



Intenta lanzar mas de una copia del emulador Sugar, con esta Actividad 
instalada en cada uno. Si estas utilizando Fedora 10 y SUGAR_PROFILE la 
Actividad no necesita estar instalada mas de una vez, pero si estas 
utilizando una version posterior de Sugar que requiere id de Usuario 
(userid) de Linux independiente para cada instancia, necesitas mantener 
copias separadas del codigo para cada usuario. En tu propio proyecto 
usar un repositorio central Git en git.sugarlabs.org puede hacer esta 
tarea mucho mas sencilla. Solo tienes que postear una copia de los 
cambios que realices en el repositorio central y Git enviara (pull) una 
copia al segundo id de usuario (userid). El segundo id de usuario (userid) 
puede usar la URL publica del repositorio. No es necesario configurar 
SSH para otro usuario que el primero. 
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Puedes haber leido en algun lugar que es posible instalar una Actividad 
en una maquina y compartir esta Actividad con alguien mas que no 
tenga esa Actividad instalada. En este caso la segunda maquina podria 
conseguir una copia de la Actividad desde la primer maquina e instalaria 
automaticamente. Probablemente tambien leiste que si dos usuarios de 
una Actividad compartida tienen diferentes versiones de la misma, 
entonces quien tenga la version mas reciente actualizara a la mas 
antigua. Ninguna de estas afirmaciones es cierta hoy y no parece que 
lleguen a ser ciertas en un futuro cercano. Estas ideas se discuten en las 
listas de correo de vez en cuando, pero existen dificultades practicas que 
es necesario veneer antes de que cualquiera de estas caracteristicas 
pueda funcionar, la mayoria de estas dificultades tienen que ver con la 
seguridad. For ahora ambos usuarios de una Actividad compartida deben 
tener la Actividad instalada. For otro lado, dependiendo de como esta 
escrita la Actividad, dos versiones diferentes de la misma podrian 
establecer comunicacion una con otra. Si los mensajes que se 
intercambian estan en el mismo formato no deberia haber problemas de 
comunicacion entre diferentes versiones. 

Una vez que tengas ambas instancias del emulador-sugar ejecutandose, 
puedes lanzar la Actividad MiniChat en una instancia e invitar al segundo 
usuario a unirse a la sesion de Chat. Fuedes hacer ambas cosas desde la 
vista Vecindario (Neighborhood). 

Las invitaciones se hacen de la siguiente manera: 




^ Make ' 



Invite to Mini Cliat Act" 



l|S^ 



Aceptar a un amigo se ve asi: 
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Mini Cliat Activity 



#1^ 



Despues que hayas jugado con la Actividad MiniChat por unos 
momentos, hablaremos de los secretos del uso de Telepathy para crear 
una Actividad compartida. 

Conocer a tus amigos (buddies) 

Como hemos dicho anteriormente, XMPP es el Protocolo de Mensajeria y 
Presencia Extendido (por sus siglas en ingles Extended Messaging and 
Presence Protocol). Presencia es lo que parece; te permite saber quien 
esta disponible para compartir una Actividad, asi como tambien que 
otras Actividades compartidas por otros estan disponibles. Existen dos 
formas de compartir una Actividad. La primera de ellas es cuando 
cambias el menu desplegable Compartir con (Share with) de la barra 
de herramientas principal, entonces deberia quedar Mi Vecindario (My 
Neighborhood) en lugar de Privado (Private). Esto significa que 
cualquiera en la red puede compartir tu Actividad. Otra forma de 
compartir una Actividad es ir a la vista de Vecindario (Neighborhood) e 
invitar a alguien especifico para compartirla. La persona a la que le Mega 
la invitacion no sabe realmente si la invitacion fue hecha 
especificamente para ella o para todos los usuarios que estan en la red 
en el Vecindario. El termino tecnico que se utiliza para referirse a las 
personas que comparten tu Actividad es Buddies. El lugar donde los 
Buddies se encuentran y colaboran se conoce como MUC o Multi User 
Chatroom. (Sala de Chat de multiples usuarios) 

El codigo usado por nuestra Actividad para invitar a los Buddies y para 
unirse como un Buddy a una Actividad iniciada por alguien mas, este en 
el metodo init (): 

if self ._shared_activity : 

# we are joining the activity 
self.connect( 'joined', self ._joined_cb) 
if self . get_shared( ) : 

# we have already joined 
self ._joined_cb( ) 

else : 

# we are creating the activity 

if not self .metadata or self . metadata. get( 
' share-scope ' , 
SCOPE_PRIVATE) == SCOPE_PRIVATE : 

# if we are in private session 
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self ._alert(_( 'Off-line' ), 

_( 'Share, or invite someone.')) 
self.connect( 'shared' , self ._shared_cb) 

def _shared_cb(self , activity): 

logger . debug( ' Chat was shared') 
self ._setup( ) 

def _joined_cb(self , activity): 

"""Joined a shared activity.""" 
if not self ._shared_activity : 

return 
logger . debug( ' Joined a shared chat') 
for buddy in \ 

self ._shared_activity . get_joined_buddies( ) : 

self ._buddy_already_exists( buddy) 
self ._setup( ) 

def _setup(self ) : 

self . text_channel = TextChannelWrapper( 

self ._shared_activity . telepathy_text_chan, 

self ._shared_activity . telepathy_conn) 
self. text_channel . set_received_callback( 

self ._received_cb) 
self ._alert(_( 'On-line'), _(' Connected')) 
self ._shared_activity .con nee t( 'buddy-joined' , 

self ._buddy_joined_cb) 
self ._shared_activity .con nee t( 'buddy-left', 

self ._buddy_lef t_cb) 
self. entry. set _sensitive(True) 
self. entry. grab_focus( ) 

Existen dos formas de iniciar una Actividad: iniciando la Actividad o 
uniendose a una Actividad que alguien mas inicio. La primera linea 
arriba en negrita determina si nos estamos uniendo o somos el primer 
usuario de una Actividad. Entonces invocamos que se ejecute el metodo 
Joined_cb()cuando el evento 'joined' ocurre. Este metodo obtiene una 
lista de Buddies desde el objeto _shared_activity y crea mensajes en la 
interfaz del usuario informando al usuario que esos Buddies ya se 
encuentran en la sala de chat (chat room). Finalmente ejecuta el 
metodo _setup(). 

Si no nos estamos uniendo a una Actividad existente entonces 
verificamos si estamos compartiendo la Actividad con alguien. Si no lo 
estamos haciendo desplegamos un mensaje diciendole al usuario que 
invite a alguien al chat. Tambien hacemos una solicitud cuando el 
evento 'shared' sucede para que se ejecute el metodo _shared_cb(). 
Este metodo simplemente invoca al metodo _setup(). 
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El metodo _setup() crea un objeto TextChannelWrapper (traduccion 
aproximada: Envoltorio de Canal de Texto) utilizando el codigo en 
textchannel.py. Tambien le dice al objeto _shared_activity que se 
requiere que se invoquen ciertos metodos cuando nuevos Buddies se 
unan a la Actividad y tambien cuando algunos Buddies abandonen la 
Actividad. Todo lo que necesitas saber sobre los Buddies lo puedes 
encontrar en el codigo que esta arriba, excepto como enviarles mensajes 
a ellos. Para esto usaremos el Text Channel (Canal de Texto). No es 
necesario aprender del Canal de Texto en gran detalle porque la clase 
TextChannelWrapper hace todo lo que podrias necesitar hacer con el 
Canal de Texto y esconde los detalles de la implementacion. 



def entry_activate_cb(self , entry): 
text = entry . props . text 
logger . debug( ' Entry : %s ' % text) 
if text: 

self . add_text (self . owner, text) 
entry . props . text = '' 
if self . text_channel : 

self. text_channel. send(text) 
else : 

logger . debug( 

'Tried to send message but text ' 
'channel not connected.') 

El metodo add_text()es interesante. Identifica al propietario del 
mensaje y los colores del entorno (podria decirse el borde del icono que 
tiene la XO) que le corresponden y muestra los mensajes en ese color. 
En el caso de mensajes enviados por la Actividad toma al propietario de 
la Actividad dentro el metodo init ()de esta forma: 

self. owner = self ._pservice. get_owner( ) 

En el caso de mensajes recibidos se obtiene el Buddy emisor de esta 
forma: 

def _received_cb(self , buddy, text): 

"""Show message that was received.""" 
if buddy: 

nick = buddy . props . nick 
else : 

nick = '???' 
logger . debug( ' Received message from %s : %s ' , 

nick, text) 
self .add_text(buddy, text) 

Pero, ique sucede si queremos hacer mas que solo enviar mensajes de 
texto hacia atras y hacia adelante? iQue deberiamos utilizar para esto? 
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Es una serie de tubos! 

No, no internet. Telepathy tiene un concepto llamado Tuberias (Tubes) 
que describe como diferentes instancias de una Actividad pueden 
comunicarse entre ellas. Lo que Telepathy hace es tomar el Canal de 
texto y construir tuberias encima de este. Existen dos tipos de Tuberias: 

• Tuberias D-Bus (D-Bus Tubes) 

• Tuberias de Flujo (Stream Tubes) 

Se utiliza una Tuberfa D-Bus (D-Bus Tube) para que la instancia de una 
Actividad pueda invocar metodos en una instancia Buddy de la Actividad. 
Una Tuberfa de Flujo (Stream Tube) se utiliza para enviar datos por 
medio de Sockets, por ejempio para copiar un archivo desde una 
instancia a otra de una Actividad. Un Socket es una via de comunicacion 
sobre la red que utiliza Protocolos de Internet. Un socket en informatica 
es un espacio virtual que sirve como entrada y salida para intercambiar 
comunicaciones entre equipos, por ejempio la implementacion del 
Protocolo HTTP que se utiliza en Internet (World Wide Web) es 
implementada con Sockets. En el siguiente ejempio vamos a usar HTTP 
para transferir libros desde una instancia de Read Etexts III a otra. 

Read Etexts III, Ahora puedes compartir libros! 

El repositorio Git con los codigos de ejempio de este libro tiene un 
archivo llamado ReadEtextsActivity3.py en el directorio 
Making_Shared_Activities que se ve de esta manera: 

import sys 

import OS 

import logging 

import tempfile 

import time 

import zipfile 

import pygtk 

import gtk 

import pango 

import dbus 

import gobject 

import telepathy 

from sugar . activity import activity 

from sugar . graphics import style 

from sugar import network 

from sugar . datastore import datastore 

from sugar . graphics . alert import NotifyAlert 

from toolbar import ReadToolbar, ViewToolbar 

from gettext import gettext as _ 

page=0 
PAGE_SIZE = 45 
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TOOLBAR_READ = 2 

logger = logging . getLogger( ' read-etexts2-activity ' ) 

class ReadHTTPRequestHandler ( 

ne two rk.ChunkedGlibHTTPRequest Handler) : 

"""HTTP Request Handler for transferring document 

while collaborating. 

RequestHandler class that integrates with Glib 
mainloop. It writes the specified file to the 
client in chunks, returning control to the 
mainloop between chunks. 



def translate_path(self , path): 

"""Return the filepath to the shared document.""" 
return self . server . filepath 



class ReadHTTPServer(network.GlibTCPServer) : 

"""HTTP Server for transferring document while 
collaborating . """ 

def init (self, server_address, filepath): 

"""Set up the GlibTCPServer with the 
ReadHTTPRequestHandler . 

filepath -- path to shared document to be served. 

ri II M 

self .filepath = filepath 

network .GlibTCPServer . init (self, 

server_ad dress, ReadHTTPRequestHandler) 



class ReadURLDownloader(network. GlibURLDownloader) : 
"""URLDownloader that provides content-length and 
content-type . """ 

def get_content_length(self ) : 

"""Return the content-length of the download.""" 
if self._info is not None: 

return int( self. _info. headers. get( 
'Content-Length' ) ) 

def get_content_type(self ) : 

"""Return the content-type of the download.""" 
if self._info is not None: 

return self. _info. headers. get ( 'Content-type' ) 
return None 

READ_STREAM_SERVICE = ' read -etexts-activity- http ' 

class ReadEtextsActivity(activity .Activity) : 

def init (self, handle): 

"The entry point to the Activity" 

global page 

activity .Activity . init (self, handle) 

self .fileserver = None 
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self .object_id = handle .object_id 

toolbox = activity .ActivityToolbox(self) 
activity_toolbar = toolbox. get_activity_toolbar( ) 
activity_toolbar . keep . props .visible = False 

self .edit_toolbar = activity . EditToolbar( ) 
self .edit_toolbar . undo . props .visible = False 
self .edit_toolbar . redo . props .visible = False 
self .edit_toolbar . separator . props .visible = False 
self .edit_toolbar .copy. set_sensitive( False) 
self .edit_toolbar .copy.connect( 'clicked', 

self . edit_toolbar_copy_cb) 
self .edit_toolbar . paste . props .visible = False 
toolbox. add_toolbar(_( 'Edit'), self. edit_toolbar ) 
self .edit_toolbar . show( ) 

self . read_toolbar = ReadToolbar ( ) 

toolbox. ad d_toolbar(_( ' Read ' ) , self . read_toolbar ) 

self. read_toolbar .bacl<.connect( 'clicked', 

self . go_back_cb) 
self. read_toolbar . forward .connect( 'clicked', 

self . go_f orward_cb) 
self. read_toolbar . num_page_entry. connect ( ' activate ' 

self . num_page_entry_activate_cb) 
self. read_toolbar . show( ) 

self . view_toolbar = ViewToolbar ( ) 

toolbox. add_toolbar(_( 'View' ), self . view_toolbar ) 

self . view_toolbar . connect ( 'go-fullscreen' , 

self . view_toolbar_go_f ullscreen_cb) 
self . view_toolbar . zoom_in .connect( 'clicked', 

self . zoom_in_cb) 
self . view_toolbar . zoom_out .connect( 'clicked' , 

self . zoom_out_cb) 
self . view_toolbar . show( ) 

self. set_toolbox( tool box) 

toolbox. show( ) 

self . scrolled_window = gtk. ScrolledWindow( ) 

self . scrolled_window. set_policy (gtk . POLICY_NEVER, 

gtk.POLICY_AUTOMATIC) 
self . scrolled_window. props . shadow_type = \ 

gtk.SHADOW_NONE 

self . textview = gtk .TextView( ) 
self. textview. set_editable(False) 
self. textview. set_cur so r_visible( False) 
self. textview. set_lef t_margin(50) 
self. textview. connect ( "key_press_event", 
self . keypress_cb) 

self . progressbar = gtk . ProgressBar () 
self.progressbar. set_orientation( 

gtk.PROGRESS_LEFT_TO_RIGHT) 
self. progressbar. set_f raction(0.0) 

self. scrolled_window. ad d(self. textview) 
self. textview. show( ) 
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self . scrolled_window. show( ) 

vbox = gtk.VBox() 

vbox. pack_start(self . progressbar, False, 

False, 10) 
vbox. pack_start(self . scrolled_window) 
self. set_canvas(vbox) 
vbox. show( ) 

page = 

self .clipboard = gtk.Clipboard( 

display=gtk . gdk . display_get_default ( ) , 

selection="CLIPBOARD" ) 
self.textview. grab_focus( ) 
self .font_desc = pango . FontDescription( "sans %d" % 

style. zoom(10) ) 
self . textview.modify_font (self . font_desc) 

buffer = self . textview. get_buffer( ) 
self .markset_id = buffer . connect( "mark-set", 
self .mark_set_cb) 

self . toolbox. set_current_toolbar(TOOLBAR_READ) 

self . unused_download_tubes = set() 

self . want_document = True 

self . download_content_length = 

self .download_content_type = None 

# Status of temp file used for write_file: 

self . tempf ile = None 

self .close_requested = False 

self. connect(" shared", self. shared_cb) 

self . is_received_document = False 

if self ._shared_activity and \ 
handle . object_id == None: 

# We're joining, and we don't already have 

# the document. 

if self . get_shared( ) : 

# Already joined for some reason, just get the 

# document 

self .joined_cb (self ) 
else : 

# Wait for a successful join before trying to get 

# the document 

self. connect ("joined", self. joined_cb) 

def keypress_cb(self , widget, event): 

"Respond when the user presses one of the arrow keys" 

keyname = gtk . gdk. keyval_name(event . keyval) 

print keyname 

if keyname == 'plus': 

self . font_increase( ) 

return True 
if keyname == 'minus': 

self . font_decrease( ) 

return True 
if keyname == 'Page_Up' : 

self . page_previous( ) 
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return True 
if keyname == 'Page_Down': 

self . page_next( ) 

return True 
if keyname == 'Up' or keyname == 'KP_Up' \ 
or keyname == 'KP_Left': 

self . scroll_up( ) 

return True 
if keyname == 'Down' or keyname == ' KP_Down ' \ 
or keyname == 'KP_Right': 

self . scroll_down( ) 

return True 
return False 

def num_page_entry_activate_cb(self , entry): 
global page 
if entry . props . text : 

new_page = int(entry. props . text) - 1 
else: 

new_page = 

if new_page >= self . read_toolbar . total_pages : 

new_page = self . read_toolbar . total_pages - 1 

elif new_page < 0: 
new_page = 

self . read_toolbar . current_page = new_page 

self. read_toolbar . set_current_page(new_page) 

self. show_page(new_page) 

entry . props . text = str(new_page + 1) 

self. read_toolbar . update_nav_buttons( ) 

page = new_page 

def go_back_cb(self , button): 
self. page_previous( ) 

def go_forward_cb(self , button): 
self. page_next ( ) 

def page_previous(self ) : 
global page 
page=page-l 
if page < 0: page=0 

self. read_toolbar . set_current_page(page) 
self. show_page(page) 
v_adjustment = \ 

self . scrolled_window. get_vad just men t( ) 
v_adjustment .value = v_adjustment . upper - \ 

v_adjustment . page_size 

def page_next (self ) : 
global page 
page=page+l 

if page >= len(self . page_index) : page=0 
self. read_toolbar . set_current_page(page) 
self. show_page(page) 
v_adjustment = \ 

self . scrolled_window. get_vad just men t( ) 
v_adjustment .value = v_adjustment . lower 
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def zoom_in_cb(self , button): 
self . font_increase( ) 

def zoom_out_cb(self , button): 
self .f on t_decr ease ( ) 

def font_decrease(self ) : 

font_size = self . f ont_desc. get_size( ) / 1024 
font_size = font_size - 1 
if font_size < 1: 
font_size = 1 
self .font_desc. set_size(font_size * 1024) 
self . textview.modify_font (self . font_desc) 

def font_increase(self ) : 

font_size = self . f ont_desc. get_size( ) / 1024 
font_size = font_size + 1 
self .font_desc . set_size(font_size * 1024) 
self . textview.modify_font (self . font_desc) 

def mark_set_cb(self , textbuffer, iter, textmark) : 

if textbuffer. get_has_selection( ) : 

begin, end = textbuffer . get_selection_bounds( ) 
self . edit_toolbar .copy. set _sensitive(True) 

else : 

self . edit_toolbar .copy. set _sensitive(False) 

def edit_toolbar_copy_cb(self , button): 

textbuffer = self . textview. get_buffer( ) 
begin, end = textbuffer . get_selection_bounds( ) 
copy_text = textbuffer . get_text(begin, end) 
self. clipboard. set_text(copy_text ) 

def view_toolbar_go_f ullscreen_cb(self , view_toolbar ) : 
self . f ullscreen( ) 

def scroll_down(self ) : 
v_adjustment = \ 

self . scrolled_window. get_vadjustment( ) 
if v_adjustment .value == v_adjustment . upper - \ 
v_ad just men t . page_size : 
self . page_next( ) 
return 
if v_adjustment .value < v_adjustment . upper - \ 
v_ad just men t . page_size : 
new_value = v_adjustment .value + \ 

v_adjustment . step_increment 
if new_value > v_adjustment . upper - \ 
v_adj ustment . page_size : 
new_value = v_adjustment . upper - \ 
v_adj ustment . page_size 
v_adj ustment .value = new_value 

def scroll_up(self ) : 
v_adjustment = \ 

self . scrolled_window. get_vadj ustment ( ) 
if v_adjustment .value == v_adjustment .lower : 
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self . page_previous( ) 
return 
if v_adjustment .value > v_adjustment . lower : 
new_value = v_adjustment .value - \ 

v_adjustment . step_increment 
if new_value < v_adjustment . lower : 

new_value = v_adjustment . lower 
v_adjustment .value = new_value 

def show_page(self , page_number) : 

global PAGE_SIZE, current_word 

position = self . page_index[page_number] 

self .etext_file. seek(position) 

linecount = 

label_text = '\n\n\n' 

textbuffer = self . textview. get_buffer( ) 

while linecount < PAGE_SIZE: 

line = self . etext_file. readline( ) 
label_text = label_text + unicode(line, 

'iso-8859-1' ) 
linecount = linecount + 1 

label_text = label_text + '\n\n\n' 

textbuffer . set_text(label_text) 

self. textview. set_buffer(textbuffer) 

def save_extracted_f ile(self , zipfile, filename): 

"Extract the file to a temp directory for viewing" 
filebytes = zipfile . read(filename) 
outfn = self .make_new_filename(f ilename) 
if (outfn == ' ' ) : 

return False 
f = open(os . path . join(self . get_activity_root ( ) , 

'tmp', outfn), 'w') 
try: 

f.write(file bytes) 
finally: 

f . close( ) 

def get_saved_page_number(self ) : 
global page 

title = self .metadata. get('title' , '') 
if title == ' ' or not \ 

title[len(title)-l] .isdigit() : 
page = 
else: 

i = len(title) - 1 
newPage = ' ' 

while (title[i] . isdigitO and i > 0) : 
newPage = title[i] + newPage 
i = i - 1 
if title[i] == 'P' : 

page = int(newPage) - 1 
else : 

# not a page number; maybe a 

# volume number, 
page = 

def save_page_number(self ) : 
global page 
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title = self .metadata. get( 'title' , '') 
if title == ' ' or not \ 

title[len(title)- 1] . isdigit( ) : 
title = title + ' p' + str(page + 1) 
else : 

i = len(title) - 1 

while (title[i] . isdigit( ) and i > 0): 

i = i - 1 
if title[i] == 'P' : 

title = title[0:i] + 'P' + str(page + 1) 
else : 

title = title + ' p' + str(page + 1) 
self .metadata[ 'title'] = title 

def read_file(self , filename): 
"Read the Etext file" 
global PAGE_SIZE, page 

tempfile = os . path . join(self . get_activity_root( ) , 

'instance', 'tmp%i' % time.time()) 
OS . link(filename, tempfile) 
self . tempfile = tempfile 

if zipf ile . is_zipf ile(filename) : 

self.zf = zipf ile .ZipFile(filename, 'r') 
self . book_f iles = self .zf . namelist( ) 
self . save_extracted_file(self . zf , 

self .book_f iles [0] ) 
currentFileName = os . path . join( 
self. get_activity_root ( ) , 
'tmp', self . book_files[0] ) 
else : 

currentFileName = filename 

self .etext_file = open(currentFileName, "r" ) 

self . page_index = [ ] 

pagecount = 

linecount = 

while self . etext_f ile : 

line = self .etext_file . readline( ) 
if not line: 

break 
linecount = linecount + 1 
if linecount >= PAGE_SIZE: 

position = self . etext_file. tell( ) 
self. page_index. append(position) 
linecount = 
pagecount = pagecount + 1 
if filename . endswith( ". zip" ) : 

OS . remove (currentFileName) 
self . get_saved_page_number( ) 
self . show_page(page) 
self . read_toolbar . set_total_pages( 

pagecount + 1) 
self . read_toolbar . set_current_page(page) 

# We've got the document, so if we're a shared 

# activity, offer it 
if self .get_shared( ) : 
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self .watch_for_tubes( ) 
self . share_document ( ) 

def rtiake_new_f ilename(self , filename): 

partition_tuple = filename. rpartition( '/' ) 
return partition_tuple[2] 

def write_file(self , filename): 

"Save meta data for the file." 
if self . is_received_document : 

# This document was given to us by someone, so 

# we have to save it to the Journal. 
self.etext_file.seek(0) 
filebytes = self . etext_file. read( ) 

f = open(filename, 'wb') 
try: 

f.write(filebytes) 
finally: 

f . close( ) 
elif self . tempfile : 

if self . close_requested : 

OS . link(self. tempfile, filename) 
logger . debug( 

"Removing temp file %s because we " 
"will close", 
self . tempfile) 
OS. unlink(self. tempfile) 
self . tempfile = None 
else: 

# skip saving empty file 
raise NotlmplementedError 

self .metadata[ ' activity ' ] = self .get_bundle_id( ) 
self. save_page_number( ) 

def can_close(self ) : 

self .close_requested = True 
return True 

def joined_cb(self , also_self): 

"""Callback for when a shared activity is joined. 

Get the shared document from another participant. 

ri t[ M 

self .watch_for_tubes( ) 

gobject . idle_add(self .get_document) 

def get_document (self ) : 

if not self .want_clocument : 
return False 

# Assign a file path to download if one 

# doesn't exist yet 

if not self ._jobject . file_path : 

path = OS . path . join(self . get_activity_root( ), 
' instance ' , 

' tmp%i' % time. time( ) ) 
else: 

path = self ._jobject . file_path 
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# Pick an arbitrary tube we can try to 

# download the document from 
try: 

tube_id = self . unused_download_tubes . pop( ) 
except (ValueError, KeyError), e: 
logger . debug( 

'No tubes to get the document ' 

'from right now: %s ' , 

e) 
return False 

# Avoid trying to download the document multiple 

# timesat once 

self .want_document = False 

gobject .idle_add(self . download_document, tube_id, path) 

return False 

def download_document (self , tube_id, path): 

Chan = self ._shared_activity . telepathy_tubes_chan 
iface = chan[telepathy.CHANNEL_TYPE_TUBES] 
addr = iface .AcceptStreamTube(tube_id, 

telepathy . S0CKET_ADDRESS_TYPE_IPV4, 

telepathy . SOCKET_ACCESS_CONTROL_LOCALHOST, 0, 

utf8_strings=True) 
logger . debug( 'Accepted stream tube: ' 

'listening address is %r ' , 

addr) 
assert isinstance(addr, dbus. Struct) 
assert len(addr) == 2 
assert isinstance(addr [0] , str) 
assert isinstance(addr [1] , (int, long)) 
assert addr[l] > and addr[l] < 65536 
port = int(addr [1] ) 

self.progressbar.show() 
getter = ReadURLDownloader( 

"http://%s:%d/document" 

% (addr[0], port)) 
getter. connect ("finished", 

self . download_result_cb, tube_id) 
getter. connect ("progress", 

self . download_progress_cb, tube_id) 
getter. connect ("error", 

self . download_error_cb, tube_id) 
logger . debug( "Starting download to %s...", path) 
getter. start(path) 
self .download_content_length = \ 

getter . get_content_length( ) 
self .download_content_type = \ 

getter . get_content_type( ) 
return False 

def download_progress_cb(self , getter, 
bytes_downloaded, tube_id): 
if self . download_content_length > 0: 
logger . debug( 

"Downloaded %u of %u bytes from tube %u...", 
bytes_d own loaded. 
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self. downloacl_content_length, 
tube_id) 
else: 

logger .debug( "Downloaded %u bytes from tube %u...", 
bytes_downloaded, tube_id) 
total = self .download_content_length 
self. set_downloaded_bytes(bytes_downloaded, total) 
gtk . gdk. threads_enter( ) 
while gtk. events_pending( ) : 

gtk. main_iteration( ) 
gtk . gdk. threads_leave( ) 

def set_downloaded_bytes(self , bytes, total): 
fraction = float(bytes) / float(total) 
self.progressbar. set_fraction( fraction) 
logger . debug( "Downloaded percent", fraction) 

def clear_downloaded_bytes(self ) : 

self.progressbar. set_f raction(0.0) 
logger . debug( "Cleared download bytes") 

def download_error_cb(self , getter, err, tube_id): 
self.progressbar.hide() 
logger . debug( 

"Error getting document from tube %u: %s" , 

tube_id, err) 
self.alert(_( 'Failure' ), 

_( 'Error getting document from tube')) 
self .want_document = True 
self .download_content_length = 
self .download_content_type = None 
gobject . idle_add(self .get_document) 

def download_result_cb(self , getter, tempfile, 
suggested_name, tube_id): 
if self .download_con ten t_type . startswith( 
'text/html' ) : 

# got an error page instead 
self . download_error_cb( getter, 

'HTTP Error', tube_id) 
return 

del self . unused_download_tubes 

self . tempfile = tempfile 

file_path = os . path . join(self .get_activity_root ( ) , 

'instance', '%i' % time.time()) 
logger . debug( 

"Saving file %s to datastore . . . ", file_path) 
OS . link(tempf ile, file_path) 
self ._jobject . file_path = file_path 
d at astore.write(self._j object, 

transf er_ownership=True) 

logger . debug( 

"Got document %s (%s) from tube %u", 

tempfile, suggested_name, tube_id) 
self . is_received_document = True 
self. read_file( tempfile) 
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self . save( ) 
self.progressbar.hide() 

def shared_cb(self , activityid): 

"""Callback when activity shared. 

Set up to share the document. 



# We initiated this activity and have now shared it, 

# so by definition we have the file, 
logger . debug( 'Activity became shared') 
self .watch_for_tubes( ) 

self . share_document( ) 

def share_document (self ) : 

"""Share the document. """ 
h = hash(self ._activity_id) 
port = 1024 + (h % 64511) 
logger . debug( 

'Starting HTTP server on port %d ' , port) 
self .fileserver = ReadHTTPServer( ("", port), 
self . tempfile) 

# Make a tube for it 

Chan = self ._shared_activity . telepathy_tubes_chan 
iface = chan[telepathy.CHANNEL_TYPE_TUBES] 
self . fileserver_tube_id = iface. OfferStreamTube( 
READ_STREAM_SERVICE, 

{}, 

telepathy . S0CKET_ADDRESS_TYPE_IPV4, 

( '127.0.0.1' , dbus.UIntl6(port)), 

telepathy . SOCKET_ACCESS_CONTROL_LOCALHOST, 

0) 

def watch_f or_tubes(self ) : 

"""Watch for new tubes.""" 

tubes_chan = self ._shared_activity . telepathy_tubes_chan 

tubes_chan[telepathy.CHANNEL_TYPE_TUBES] .\ 

connect_to_signal( 

'NewTube', self . new_tube_cb) 
tubes_chan[telepathy .CHANNEL_TYPE_TUBES] . ListTubes( 

reply_handler=self . list_tubes_reply_cb, 

error_handler=self . list_tubes_error_cb) 

def new_tube_cb(self , tube_id, initiator, tube_type, 

service, params, state): 

"""Callback when a new tube becomes available.""" 

logger . debug( 

'New tube: ID=%d initator=%d type=%d service=%s ' 
'params=%r state=%d', tube_id, initiator, 
tube_type, service, params, state) 

if service == READ_STREAM_SERVICE : 

logger . debug( ' I could download from that tube') 
self . unused_download_tubes . add(tube_id) 

# if no download is in progress, let's fetch 

# the document 

if self. want document: 
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gobject . idle_add(self .get_document ) 

def list_tubes_reply_cb(self , tubes): 

"""Callback when new tubes are available.""" 
for tube_info in tubes: 

self . new_tube_cb(*tube_info) 

def list_tubes_error_cb(self , e): 

"""Handle ListTubes error by logging.""" 
logger . error (' ListTubes( ) failed: %s ' , e) 

def alert(self, title, text=None): 
alert = NotifyAlert(timeout=20) 
alert . props . title = title 
alert . props .msg = text 
self . ad d_alert( alert ) 

alert .connect( 'response', self. alert_cancel_cb) 
alert . show( ) 

def alert_cancel_cb(self , alert, response_id) : 
self. remove_alert (alert ) 
self. text view. grab_focus( ) 

Estas lineas son el contenido de activity.info: 

[Activity] 

name = Read Etexts III 

service_name = net . flossmanuals . ReadEtextsActivity 

icon = read-etexts 

exec = sugar-activity ReadEtextsActivityS . ReadEtextsActivity 

show_launcher = no 

activity_version = 1 

mime_types = text/plain;application/zip 

license = GPLv2+ 

Para probar la Actividad, descarga el libro Project Gutenberg al Diario 
(Journal), abrelo con la ultima version de Read Etexts III y luego 
comparte la Actividad con un segundo usuario que tenga la Actividad 
instalada pero no ejecutandose. El segundo usuario debe aceptar la 
invitacion que le aparece en su vista Vecindario. Cuando el segundo 
usuario acepta, Read Etexts III se iniciara y copiara el libro desde el 
primer usuario a traves de la red y lo cargara. La Actividad primero 
mostrara una pantalla en bianco, pero luego una barra de progreso 
aparecera debajo de la barra de herramientas (toolbar) y mostrara el 
progreso de la copia. Cuando se termine de hacer la copia, la primer 
pagina del libro se mostrara en pantalla. 
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Entonces, icomo funciona esto? Miremos el codigo. Los primeros puntos 
de interes son las definiciones de clases que aparecen al principio: 
ReadHTTPRequestHandler, ReadHTTPServer, y 
ReadURLDownloader. Estas tres clases extienden (es una forma de 
decir que heredan codigo desde clases padre) clases provistas por el 
paquete sugar. network (paquete en el cual se encuentran agrupadas 
todas las clases que trabajan con los mecanismos de red de las XO). 
Estas clases proveen un Cliente HTTP para recibir el libro y un Servidor 
HTTP para enviar el libro. 

Este es el codigo usado para enviar un libro: 

def shared_cb(self , activityid): 

"""Callback when activity shared. 

Set up to share the document. 

ri II M 

# We initiated this activity and have now shared it, 

# so by definition we have the file, 
logger . debug( 'Activity became shared') 
self . watch_for_tubes( ) 

self . share_document( ) 

def share_document (self ) : 

"""Share the document. """ 
h = hash(self ._activity_id) 
port = 1024 + (h % 64511) 
logger . debug( 

'Starting HTTP server on port %d ' , port) 
self .fileserver = ReadHTTPServer( ( "", port), 

self . tempfile) 

# Make a tube for it 

chan = self ._shared_activity . telepathy_tubes_chan 
iface = chan[telepathy.CHANNEL_TYPE_TUBES] 
self . fileserver_tube_id = iface. OfferStreamTube( 
READ_STREAM_SERVICE, 

{}, 

telepathy . S0CKET_ADDRESS_TYPE_IPV4, 

( '127.0.0.1' , dbus.UIntl6(port)), 

telepathy . SOCKET_ACCESS_CONTROL_LOCALHOST, 

0) 

Notaras que haciendo un hash (hash es una funcion propia de Python 
que retorna un codigo casi unico asociado a un objeto) del _activity_id 
se obtiene un numero de puerto. Este puerto es usado por el Servidor 
HTTP y es pasado a Telepathy, la que lo pone a disposicion como una 
Tuberfa de Flujo (Stream Tube). Del lado del receptor tenemos el 
siguiente codigo: 

def joined_cb(self , also_self): 

"""Callback for when a shared activity is joined. 

Get the shared document from another participant. 
II II II 
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self .watch_for_tubes( ) 

gobject . idle_add(self .get_document) 

def get_document (self ) : 

if not self .want_clocument : 
return False 

# Assign a file path to download if one doesn't 

# exist yet 

if not self ._jobject . file_path : 

path = OS . path . join(self . get_activity_root( ), 
' instance ' , 

' tmp%i' % time. time( ) ) 
else: 

path = self ._jobject . file_path 

# Pick an arbitrary tube we can try to download the 

# document from 
try: 

tube_id = self . unused_download_tubes . pop( ) 
except (ValueError, KeyError), e: 
logger . debug( 

'No tubes to get the document from ' 

'right now: %s ' , 

e) 
return False 

# Avoid trying to download the document multiple 

# times at once 

self .want_document = False 

gobject . idle_add(self .download_document, 

tube_id, path) 
return False 

def download_document (self , tube_id, path): 

Chan = self ._shared_activity . telepathy_tubes_chan 
iface = chan[telepathy.CHANNEL_TYPE_TUBES] 
addr = iface .AcceptStreamTube(tube_id, 
telepathy . S0CKET_ADDRESS_TYPE_IPV4, 
telepathy . SOCKET_ACCESS_CONTROL_LOCALHOST, 

0, 

utf8_strings=True) 
logger . debug( 

'Accepted stream tube: listening address is %r ' , 

addr) 
assert isinstance(addr, dbus. Struct) 
assert len(addr) == 2 
assert isinstance(addr [0] , str) 
assert isinstance(addr [1] , (int, long)) 
assert addr[l] > and addr[l] < 65536 
port = int(addr[l]) 

self.progressbar.show() 
getter = ReadURLDownloader( 

"http://%s:%d/document" 

% (addr[0], port)) 
getter. connect ("finished", 

self . download_result_cb, tube_id) 
getter. connect ("progress", 
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self . download_progress_cb, tube_id) 
getter. connect ("error", 

self . download_error_cb, tube_id) 
logger . debug( 

"Starting download to %s...", path) 
getter. start(path) 
self .download_content_length = \ 

getter . get_content_length( ) 
self . download_content_type = \ 

getter . get_content_type( ) 
return False 

def download_progress_cb(self , getter, 
bytes_downloaded, tube_id): 
if self . download_content_length > 0: 
logger . debug( 

"Downloaded %u of %u bytes from tube %u . . . 
bytes_downloaded, 
self .download_content_length, 
tube_id) 
else : 

logger . debug( 

"Downloaded %u bytes from tube %u...", 
bytes_downloaded, tube_id) 
total = self . download_content_length 
self . set_downloaded_bytes(bytes_downloaded, 

total) 
gtk. gdk . threads_enter( ) 
while gtk.events_pending( ) : 

gtk . main_iteration( ) 
gtk. gdk . threads_leave( ) 

def download_error_cb(self , getter, err, tube_id): 
self.progressbar.hide() 
logger . debug( 

"Error getting document from tube %u : %s", 

tube_id, err) 
self.alert(_( 'Failure' ), 

_( 'Error getting document from tube')) 
self .want_document = True 
self .download_content_length = 
self .download_content_type = None 
gobject . idle_add(self . get_document ) 

def download_result_cb(self , getter, tempfile, 
suggested_name, tube_id): 
if self .download_content_type . startswith( 
'text/html' ) : 

# got an error page instead 
self . d own load_error_cb( getter, 

'HTTP Error', tube_id) 
return 

del self . unused_download_tubes 

self . tempfile = tempfile 

file_path = os . path . join(self . get_activity_root ( ) , 

' instance ' , 

'%i' % time.timeO) 
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logger . debug( 

"Saving file %s to datastore . . . ", file_path) 
OS . link(tempf ile, file_path) 
self ._jobject . file_path = file_path 
d at astore.write(self._j object, 

transfer_ownership=True) 

logger . debug( 

"Got document %s (%s) from tube %u" , 

tempfile, suggested_name, tube_id) 
self . is_received_document = True 
self. read_file( tempfile) 
self. save( ) 
self.progressbar.hide() 

Telepathy nos proporciona la direccion y el numero de puerto asociado a 
una Tuberia de Flujos (Stream Tube) y configuramos el Cliente HTTP 
para que lea desde alii. El cliente lee el archive por porciones y despues 
de leer cada porcion llama al metodo download_progress_cb() y 
entonces podemos actualizar una barra de progreso para mostrar el 
progreso de la descarga. Hay tambien metodos para el caso en que se 
produzca un error de descarga y para cuando la descarga haya 
terminado. 

La clase ReadURLDownloader no es solo util para transferir archivos 
por medio de una Tuberia de Flujos (Stream Tube), tambien puede 
utilizarse para interactuar con sitios web (websites) y servicios web (web 
services). Mi Actividad Get Internet Archive Books usa esta clase para 
este proposito. 

La unica pieza restante es el codigo que controla la obtencion de datos 
desde la Tuberia de Flujo. En este codigo, adaptado de la Actividad Read 
(Leer), tan pronto como una instancia de la Actividad recibe un libro 
cambia de receptora a emisora y ofrece el libro para compartir, de este 
modo la Actividad podria tener varias Tuberias desde donde obtener el 
libro: 

READ_STREAM_SERVICE = ' read -etexts-activity- http ' 



def watch_for_tubes(self ) : 

"""Watch for new tubes. """ 
tubes_chan = self ._shared_activity .\ 
telepathy_tubes_chan 

tubes_chan [telepathy. CHANNEL_TYPE_TUBES] .\ 

connect_to_signal( 

' NewTube ' , 

self . new_tube_cb) 
tubes_chan [telepathy. CHANNEL_TYPE_TUBES] .\ 

ListTubes( 

reply_handler=self . list_tubes_reply_cb, 

error_handler=self . list_tubes_error_cb) 
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def new_tube_cb(self , tube_id, initiator, 
tube_type, service, params, state): 
"""Callback when a new tube becomes available.""" 
logger . debug( 

'New tube: ID=%d initator=%d type=%d service=%s ' 

' params=%r state=%d', tube_id, initiator, 

tube_type, 

service, params, state) 
if service == READ_STREAM_SERVICE : 

logger . debug( ' I could download from that tube') 

self . unused_download_tubes . add(tube_id) 

# if no download is in progress, 

# let's fetch the document 
if self .want_document : 

gobject . idle_add(self .get_document) 

def list_tubes_reply_cb(self , tubes): 

"""Callback when new tubes are available.""" 
for tube_info in tubes: 

self . new_tube_cb( *tube_info) 

def list_tubes_error_cb(self , e): 

"""Handle ListTubes error by logging.""" 
logger . error( ' ListTubes( ) failed: %s ' , e) 

La constante READ_STREAM_SERVICE esta definida casi al principio del 
inicio del archive fuente. 

Utilizar tuberias D-Bus (D-Bus Tubes) 

D-Bus es una forma de soportar IPC, o Comunicacion Inter-Procesos 

(Inter-Process Communication), el cual fue desarrollado por el entorno 
de trabajo GNOME (desktop environment). La idea de IPC es permitir a 
dos programas que se ejecutan simultaneamente comunicarse entre si y 
ejecutar codigo del otro. GNOME usa D-Bus para proporcionar 
comunicacion entre el entorno de trabajo y los programas que se 
ejecutan en el, y tambien entre GNOME y el sistema operativo. Una 
Tuberfa D-Bus (D-Bus Tube) es como Telepathy hace posible que una 
instancia de una Actividad que se ejecuta en una computadora pueda 
ejecutar metodos en otra instancia de la misma Actividad ejecutandose 
en otra computadora diferente. En lugar de solo enviar simples 
mensajes de texto entre las computadoras o hacer transferencias de 
archivos, sus Actividades pueden compartirse de forma segura. Esto 
significa que la Actividad puede permitir a varias personas trabajar 
juntas en la misma tarea. 

Nunca escribi una Actividad que use Tuberias D-Bus pero muchos otros 
lo han hecho. Vamos a dar un vistazo al codigo de dos de ellos: Scribble 
escrito por Sayamindu Dasgupta y Batalla Naval, escrito por Gerard J. 
Cerchio y Andres Ambrois, el cual fue escrito para el Ceibal Jam. 
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Scribble es un programa para dibujar que permite a varias personas 
trabajar en el mismo dibujo al mismo tiempo. En lugar de permitirte 
seleccionar el color con el cual vas a dibujar, este usa los colores de 
frente y fondo de tu icono de Buddy (la figura del XO) para dibujar con 
ellos. De esta forma con varias personas dibujando figuras al mismo 
tiempo es facil saber quien dibujo que. Si te unes a una Actividad 
Scribble esta actualizara tu pantalla de forma que tu dibujo coincida el 
de cualquier otro usuario. Scribble en accion se ve de la siguiente 
manera: 




Batalla Naval es una version del clasico juego Battleship (Batalla 

Naval). Cada jugador tiene dos grillas: una de ellas para ubicar sus 
propios barcos (en realidad la computadora posiciona al azar los barcos 
por ti) y otra grilla en bianco representando el area donde se encuentran 
los barcos de tu oponente. Tu no puedes ver los barcos de tu oponente y 
el no puede ver los tuyos. Puedes hacer die en la grilla de tu oponente 
(la de la derecha) para indicar donde quieres que tu artilleria dispare. 
Cuando lo haces se ilumina el recuadro correspondiente en tu grilla y el 
correspondiente en la de tu oponente. Si el cuadrado que seleccionaste 
corresponde a un cuadrado donde tu oponente tiene un barco, ese 
cuadro se mostrara en un color diferente. El objetivo del juego es 
encontrar todos los cuadrados donde estan ubicados los barcos de tu 
oponente antes de que el encuentre los tuyos. El juego en accion se ve 
asi: 
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Sugiero que descargues la version mas reciente de estas dos Actividades 
desde Gitorious utilizando estos comandos: 

mkdir scribble 

cd scribble 

git clone git : //git . sugarlabs . org/scribble/mainline . git 

cd . . 

mkdir batallanaval 

cd batallanaval 

git clone git : //git . sugarlabs . org/batalla-naval/mainline .git 

Sera necesario que realices algunas configuraciones para lograr ejecutar 
estas aplicaciones en el emulador-sugar. Scribble requiere el 
componente goocanvas de GTK y los componentes Python que se 
incluyen con ellos. Estos no fueron instalados por defecto en Fedora 10 
pero se pueden instalar por medio de Anadir/Remover Programas 
(Add/Remove Programs) desde el menu Sistema (System) en GNOME. 
Batalla Naval no incluye el archivo setup. py, pero esto es facil de 
solucionar ya que cada setup. py es identico. Copia alguno de los que 
vienen en los ejemplos del libro dentro del directorio 
mainline/BatallaNaval. activity y ejecuta ./setup. py dev en ambas 
Actividades. 

Estas Actividades utilizan diferentes estrategias de colaboracion. Scribble 
crea lineas de codigo Python el cual se pasa a todos los Buddies y cada 
Buddy usa la funcion exec para ejecutar los comandos. Este es el codigo 
que dibuja un circulo: 

def process_item_finalize(self , x, y) : 
if self. tool == 'circle': 
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self . cmd = "goocanvas . Ellipse( 
parent=self._root, 
center_x=%d, 

center_y=%d, radius_x = %d, 
radius_y = %d, 
fill_color_rgba = %d, 
stroke_color_rgba = %d, 

title = '%s')" % (self . item. props . center_x, 
self. item. props .center_y, 
self. item. props. radius_x, 
self. item. props. radius_y, 
self ._fill_c lor, 
self ._stroke_color, self .item_id) 

def process_cmd(self , cmd): 

#print 'Processing cmd :' + cmd 

exec(cmd) 

#FIXME: Ugly hack, but I'm too lazy to 

# do this nicely 

if len(self . cmd_list ) > 0: 

self . cmd_list += (';' + cmd) 
else: 

self . cmd_list = cmd 

La variable cmd_list se usa para crear una lista de cadenas de texto que 
contienen todos los comandos que se ejecutaron hasta ese momento. 
Cuando un nuevo Buddy se une a la Actividad, esta envia la variable para 
que se ejecuten todos los comandos anteriores, de esta forma el area de 
dibujo del nuevo usuario tiene el mismo contenido que los otros 
Buddies. 

Este es un enfoque interesante, pero podrias hacer lo mismo utilizando 
Canales de Texto (TextChannel) por lo que este no es necesariamente el 
mejor uso que se puede hacer de las Tuberias D-Bus (D-Bus Tubes). 
Batalla Naval hace uso de D-Bus de una forma mas tipica. 

Como funcionan mas o menos las tuberias D-Bus 

D-Bus permite que dos programas que se estan ejectando se envien 
mensajes entre si. Los programas tienen que estar ejecutandose en la 
misma computadora. Enviar un mensaje es una forma indirecta de tener 
un programa que ejecute codigo en otro programa. Un programa define 
el tipo de mensajes que esta dispuesto a recibir y ejecutar. En el caso de 
Batalla Naval se define un mensaje similar a este: "dime a que cuadrado 
quieres disparar y te hare conocer si uno de mis barcos o parte de 
alguno de ellos esta en ese cuadrado". El primer programa realmente no 
ejecuta nada en el segundo, pero el resultado final es similar. Las 
Tuberias D-Bus son una forma de habilitar que D-Bus envie mensajes 
como estos a un programa que se ejecuta en otra computadora. 
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Piensa por un minuto como podrias hacer que un programa en una 
computadora ejecute codigo en otro programa que se esta ejecutando 
en otra computadora. Por supuesto que tendria que utilizar la red. Todo 
el mundo esta familiarizado con el envio de datos por medio de una red. 
Pero en este caso tendria que enviar codigo de programa por la red. 
Deberias ser capaz de decirle al programa que se esta ejecutando en la 
segunda computadora que codigo quieres que se ejecute. Necesitaras 
enviar una invocacion a un metodo y todos los parametros que necesita 
el metodo para que se ejecute correctamente, adicionalmente 
necesitaras una forma de obtener un valor de retorno. 

<LNo es parecido a lo que hace Scribble en el codigo que recien 
miramos? <i.Podriamos hacer que nuestro codigo haga algo parecido a 
esto? 

Por supuesto si haces esto todo programa en el que quieras ejecutar 
codigo remotamente debera estar escrito para que pueda tratar con 
esto. Si tienes un abanico de programas que quieres que hagan esto, 
necesitaras alguna forma de permitir a los programas conocer cuales 
solicitudes fueron hechas para esto. Seria genial si hubiera un programa 
ejecutandose en cada computador que se encargue de hacer conexiones 
de red, convertir las invocaciones a los metodos en datos que puedan ser 
enviados por medio de la red y luego convertir esos datos nuevamente 
en invocaciones a metodos y ejecutar dichas invocaciones, ademas de 
enviar cualquier valor de retorno hacia el origen de la invocacion. Este 
programa deberia ser capaz de conocer en que programa quieres 
ejecutar el codigo y ver si la llamada al metodo se esta ejecutando alli. El 
programa deberia estar corriendo todo el tiempo, y seria realmente muy 
bueno si ejecutar un metodo en un programa remoto fuera tan simple 
como ejecutar un metodo en mi propio programa. 

Tal como lo supones, lo que hemos descrito es mas o menos lo que son 
las Tuberias D-Bus. Existen articulos que explican como funcionan en 
detalle, pero no es necesario conocer como funcionan para usarlas. 
Necesitas conocer algunas cosas sobre ellas. Primero necesitas saber 
como usar las Tuberias D-Bus para hacer objetos en tu Actividad que 
esten disponibles para ser usados por otras instancias de esa Actividad 
ejecutandose en alguna parte. 

Una Actividad que necesita usar Tuberias D-Bus debe definir sobre que 
tipo de mensajes va a actuar, en efecto que metodos especificos en el 
programa estan disponibles para este uso. Todas las actividades que 
usan Tuberias D-Bus tienen constantes similares a estas: 

SERVICE = "org . randomink . sayamindu .Scribble" 

IFACE = SERVICE 

PATH = "/org/randomink/sayamindu/Scribble" 
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Estas son las constantes utilizadas por la Actividad Scribble. La primera 
constante, llamada SERVICE (Servicio), representa el nombre de bus 
(bus name) de la Actividad. Tambien se lo llama nombre bien-conocido 
(well-known name) porque utiliza un nombre de dominio invertido 

(reversed domain name) como parte del nombre. En este caso 
Sayamindu Dasgupta tiene un sitio web en 

http://sayamindu.randomink.org entonces invierte las palabras de esta 
URL separadas por un punto para formar la primera parte del nombre 
del bus. No es necesario tener un nombre de dominio propio antes de 
poder crear un nombre de bus (bus name). Puedes utilizar 
org.sugarlabs.NombreDeTuActividad si quieres. El punto es que el 
nombre de bus debe ser unico y por convencion se hace mas sencillo 
hacerlo utilizando un nombre de dominio inverso. 

La constante PATH representa la carpeta del objeto (object path). Se ve 
como el nombre del bus con barras separando las palabras en lugar de 
los puntos. Para la mayoria de las Actividades es exactamente como 
deberia ser, pero es posible para una aplicacion exponer mas de un 
objeto hacia el D-Bus, en ese caso cada objeto expuesto deberia tener su 
propio nombre unico, por convencion palabras separadas por barras 
(slashes "/"). 

La tercer constante es IFACE, la cual es nombre de interfaz (interface 
name). Una interfaz es una coleccion de sehales y metodos relacionados, 
identificados por un nombre que utiliza la misma convencion que el 
nombre de bus. En el ejempio de arriba y probablemente en la mayoria 
de las Actividades que usan Tuberias D-Bus, el nombre de la interfaz y el 
nombre de bus son identicos. 

Entonces, ique es una sehal? Una sehal es similar a un metodo pero en 
lugar de tener un programa en ejecucion que llama a un metodo en otro 
programa, una sehal es de difusion masiva (broadcast). En otras 
palabras, en lugar de ejecutar un metodo en un solo programa este 
ejecuta el mismo metodo en varios programas en ejecucion, de hecho 
en cada programa en ejecucion que tenga este metodo conectado a 
traves de D-Bus. Una sehal puede pasar datos a la invocacion de un 
metodo pero no puede recibir ningun valor de retorno. Es como una 
estacion de radio que emite musica para todos los que esten 
sintonizando la emisora. El flujo de informacion es en un solo sentido. 
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Por supuesto una estacion de radio recibe llamadas de los 
radioescuchas. Un conductor puede pasar una nueva cancion e invitar a 
los oyentes a llamar a la estacion y decir que piensan sobre la misma. La 
llamada de telefono es una via de comunicacion bidireccional entre el 
conductor y el radioescucha, pero es iniciado mediante una llamada de 
difusion masiva hacia todos los escuchas. De la misma forma tu 
Actividad podria utilizar una serial para invitar a todos los escuchas 
(Buddies) a usar un metodo para llamar nuevamente a la Actividad 
emisora, entonces este metodo puede proporcionar y recibir 
informacion. 

Los metodos D-Bus y las senales tienen firmas (signatures). Una firma 
es una descripcion de los parametros pasados a un metodo o serial 
incluyendo su tipo de dato (data types). Python no es un lenguaje 
fuertemente tipado (strongly typed)- en informatica se usa el termino 
fuertemente tipado cuando se refiere a que el tipo de una variable debe 
ser definido explicitamente). En un lenguaje fuertemente tipado cada 
variable tiene un tipo de datos el cual define que es lo que esta puede 
hacer y/o contener. Los tipos de datos incluyen cosas como cadenas 
(strings), enteros (integers), enteros largos (long integers), numeros 
de punto flotante (floating point numbers), booleanos (booleans), etc. 
Cada uno de ellos puede ser usado para un proposito especifico. Por cada 
instancia un booleano solo puede contener uno de dos 
valoresVerdadero (True) o Falso (False). Una cadena puede ser usada 
para almacenar cadenas de caracteres, pero incluso si estos caracteres 
representan un numero no es posible utilizar las cadenas para realizar 
calculos. Lo que necesitas hacer es convertir la cadena en uno de los 
tipos numericos. Un entero puede contener enteros hasta cierto 
tamaho, y un entero largo puede contener enteros de un tamaho mucho 
mayor. Un numero de punto flotante es un numero con un punto 
decimal en notacion cientifica. Esto suele ser usado para realizar 
calculos aritmeticos, los cuales requieren resultados redondeados. 
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En Python puedes poner cualquier cosa en cualquier variable y el 
lenguaje por si mismo decidira como gestionar los mismos. Para hacer 
que Python trabaje con D-Bus, el cual requiere variables fuertemente 
tipadas, que Python no tiene, es necesario tener un forma de decirle al 
D-Bus que tipo de variables deberia tener para pasarselas a un metodo. 
Puedes hacer esto por medio del uso de una cadena de firma (signature 
string) como un argumento al metodo o sehal. Los metodos tienen dos 
cadenas: una in_signature (podria decirse que es una firma de entrada) 
y una out_signature (es la firma de salida). Las sehales solo tienen un 
parametro firma (signature). Algunos ejemplos de cadenas de firma: 



dos parametros, ambos enteros (integer) 



sss 



Tres parametros, todos cadenas (string) 



ixd 



Tres parametros, un entero (integer), un entero largo (long) y un numero de 
punto flotante de doble precision (double). 



a(ssiii: 



Un conjunto (array) donde cada elemento del conjunto es una tupla que 
contiene dos cadenas y tres enteros. 



Puedes encontrar mas informacion sobre cadenas de firma en el tutorial 
sobre dbus-python en: http://dbus.freedesktop.org/doc/dbus- 
pyth on/doc/tutorial. htm I . 

Hello Mesh (Hola malla) y Friends (Amigos) 

Si estudias el codigo fuente de algunas Actividades compartidas puedes 
darte cuenta que muchas de ellas contienen metodos casi identicos, 
como si todas ellas fueran una copia de la misma fuente. De hecho es 
probable que la mayoria si lo haya sido. La Actividad Hello Mesh fue 
desarrollada para ser un ejempio de como usar Tuberias D-Bus en una 
actividad compartida. Es clasico ver en los libros de programacion que el 
primer ejempio de programa es uno que imprime las palabras "Hola 
Mundo" (Hello World) por consola o muestra la frase en una ventana. 
Siguiendo esta tradicion Hello Mesh es un programa que no hace 
mucho mas. Podras encontrar el codigo fuente en Gitorious en 
http://git.sugarlabs.org/projects/hello-mesh . 

Hello Mesh es ampliamente copiado porque demuestra como hacer 
cosas que todas las Actividades compartidas necesitan hacer. Cuando 
tienes una Actividad compartida debes ser capaz de hacer dos cosas: 

• Enviar informacion o comandos a otras instancias de tu Actividad. 

• Proporcionar a los Buddies que se unan a tu Actividad una copia del 
estado actual de la Actividad. 

Es posible hacer esto utilizando dos sehales y un metodo: 
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• Una serial llamada HelloO que alguien que se une a la Actividad 
envia a todos los participantes. El metodo HelloO no tiene 
parametros. 

• Un metodo llamado WorldO que las instancias que reciben HelloO 
envian como respuesta al emisor que acaba de unirse. Este metodo 
toma una cadena de texto como argumento, el cual es utilizado para 
representar el estado actual de la Actividad. 

• Otra serial llamada SendTextO que envia mensajes de texto a todos 
los participantes. Estos representan una actualizacion de estado de 
la Actividad compartida. En el caso de Scribble este deberia 
informar a las otras instancias que la propia instancia acaba de 
dibujar una nueva figura. 

En lugar de estudiar la Actividad Hello Mesh por si misma, prefiero que 
demos un vistazo al codigo derivado de esta, usado en la Actividad 
Batalla Naval. 

Esta Actividad tiene la particularidad de poder ejecutarse tanto como 
Actividad o como un programa autonomo de Python. El programa 
autonomo no soporta compartir y corre en una ventana. La clase 
Activity es una subclase de Window, entonces cuando el codigo se esta 
ejecutando en modo autonomo la funcion init() en BatallaNaval.py 
obtiene una ventana, y cuando el mismo codigo se ejecuta como 
Actividad la instancia de la clase BatallaNavalActivity es pasado a 
initO: 

from sugar . activity . activity import Activity, ActivityToolbox 

import BatallaNaval 

from Collaboration import CollaborationWrapper 

class BatallaNavalActivity(Activity) : 

' ' ' The Sugar class called when you run this 
program as an Activity. The name of this 
class file is marked in the 
activity/activity . info file.''' 

def init (self, handle): 

Activity. init (self, handle) 

self . gamename = 'BatallaNaval' 

# Create the basic Sugar toolbar 
toolbox = ActivityToolbox(self ) 
self . set_toolbox( toolbox) 
toolbox. show( ) 

# Create an instance of the CollaborationWrapper 

# so you can share the activity. 

self .colaboracion = CollaborationWrapper(self ) 

# The activity is a subclass of Window, so it 

# passses itself to the init function 
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BatallaNaval. init (False, self) 

Otra habilidad que tiene BatallaNaval es que todo el codigo que posibilita 
la colaboracion se encuentra en su propia clase CollaborationWrapper 
(El nombre de esta clase es aproximadamente Contenedor de 
Colaboracion) que toma la instancia de la clase BatallNavalActivity en 
su constructor. Esto separa el codigo de colaboracion del resto del 
programa. Este es el codigo de la clase CollaborationWrapper. py: 

import logging 

from sugar . presence import presenceservice 

import telepathy 

from dbus. service import method, signal 

# In build 656 Sugar lacks sugartubeconn 

try: 

from sugar . presence . sugartubeconn import \ 
SugarTubeConnection 
except : 

from sugar . presence . tubeconn import TubeConnection as \ 
SugarTubeConnection 
from dbus . gobject_service import ExportedGObject 

' ' ' In all collaborative Activities in Sugar we are 
made aware when a player enters or leaves. So that 
everyone knows the state of the Activity we use 
the methods Hello and World. When a participant 
enters Hello sends a signal that reaches 
all participants and the participants 
respond directly using the method "World", 
which retrieves the current state of the Activity. 
After the updates are given then the signal 
Play is used by each participant to make his move. 
In short this module encapsulates the logic of 
"collaboration" with the following effect: 

- When someone enters the collaboration 
the Hello signal is sent. 

- Whoever receives the Hello signal responds 
with World 

- Every time someone makes a move he uses 
the method Play giving a signal which 
communicates to each participant 

what his move was. 



SERVICE = "org .ceibaljam. BatallaNaval" 

IFACE = SERVICE 

PATH = "/org/ceibaljam/BatallaNaval" 

logger = logging . getLogger( ' BatallaNaval' ) 
logger . set Level (logging .DEBUG) 

class CollaborationWrapper(ExportedGObject ) : 

'''A wrapper for the collaboration methods. 

Get the activity and the necessary callbacks. 
[ I I 

def init (self, activity): 
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self . activity = activity 
self . presence_service = \ 

presenceservice. get_instance( ) 
self. owner = \ 

self . presence_service. get_owner( ) 

def set_up(self, buddy_joined_cb, buddy_lef t_cb, 
World_cb, Play_cb, my_boats): 
self.activity.connect( 'shared' , 

self ._shared_cb) 
if self .activity ._sh are d_activity: 
# We are joining the activity 
self . activity. connect( 'joined', 

self ._joined_cb) 
if self . activity . get_shared( ) : 
# We've already joined 
self ._joined_cb( ) 

self . buddy_joined = buddy_joined_cb 
self . buddy_lef t = buddy_lef t_cb 
self .World_cb = World_cb 

# Called when someone passes the board state. 
self.Play_cb = Play_cb 

# Called when someone makes a move. 

# Submitted by making World on a new partner 
self . my_boats = [(b.nombre, b . orientacion, 

b. largo, b.pos[0], 

b.pos[l]) for b in my_boats] 
self. world = False 
self. entered = False 

def _shared_cb(self , activity): 
self ._sharing_setup( ) 
self .tubes_chan[ telepathy. CHANNEL_TYPE_TUBES] .\ 

OfferDBusTube( 

SERVICE, {}) 
self .is_initiator = True 

def _joined_cb(self , activity): 

self ._sharing_setup( ) 

self .tubes_chan[ telepathy. CHANNEL_TYPE_TUBES] .\ 
ListTubes( 

reply_handler=self ._list_tubes_reply_cb, 
error_handler=self ._list_tubes_error_cb) 

self . is_initiator = False 

def _sharing_setup(self ) : 

if self .activity ._shared_activity is None: 
logger . error( 

'Failed to share or join activity') 
return 

self. conn = \ 

self . activity ._shared_activity. telepathy_conn 
self . tubes_chan = \ 

self . activity ._shared_activity. telepathy_tubes_chan 
self . text_chan = \ 

self . activity ._shared_activity. telepathy_text_chan 
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self .tubes_chan[ telepathy. CHANNEL_TYPE_TUBES] A 
connect_to_signal( 
'NewTube', self ._new_tube_cb) 

self .activity ._shared_activity. connect ( 

' buddy- joined ' , 

self ._buddy_joined_cb) 
self .activity ._shared_activity. connect ( 

'buddy-left', 

self ._buddy_lef t_cb) 

# Optional - included for example: 

# Find out who's already in the shared activity: 
for buddy in \ 

self . activity ._shared_activity.\ 

get_joined_buddies( ) : 
logger .debug( 

'Buddy %s is already in the activity', 

buddy. props . nick) 

def participant_change_cb(self , added, removed): 
logger . debug( 

'Tube: Added participants: %r ' , added) 
logger . debug( 

'Tube: Removed participants: %r ' , removed) 
for handle, bus_name in added: 

buddy = self ._get_buddy(handle) 
if buddy is not None: 
logger . debug( 

'Tube: Handle %u (Buddy %s) was added', 
handle, buddy . props . nick) 
for handle in removed: 

buddy = self ._get_buddy(handle) 
if buddy is not None: 

logger . debug( ' Buddy %s was removed' % 
buddy. props . nick) 
if not self . entered : 

if self . is_initiator : 
logger . debug( 

"I'm initiating the tube, " 
"will watch for hellos.") 
self .add_hello_handler( ) 
else : 

logger . debug( 

'Hello, everyone! What did I miss?') 
self .HelloO 
self. entered = True 



# This is sent to all participants whenever we 

# join an activity 

§signal(dbus_interface=IFACE, signature=' ' ) 
def Hello(self ) : 

"""Say Hello to whoever else is in the tube.""" 
logger . debug( ' I said Hello.') 

# This is called by whoever receives our Hello signal 

# This method receives the current game state and 
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# puts us in sync with the rest of the participants. 

# The current game state is represented by the 

# game object 

§method(dbus_interf ace=IFACE, in_signature= 'a(ssiii) ' , 

out_signature= ' a(ssiii) ' ) 
def World(self, boats): 

"""To be called on the incoming XO after 

they Hello.""" 

if not self. world: 

logger . debug( 'Somebody called World on me') 
self. world = True # Instead of loading 

# the world, I am 

# receiving play by 

# play, 
self . Wo rld_cb( boats) 

# now I can World others 
self . add_hello_handler( ) 

else : 

self. world = True 

logger . debug( 

"I've already been welcomed, doing nothing") 
return self .my_boats 

©signal (dbus_interface=I FACE, signature='ii' ) 

def Play(self, x, y) : 

"""Say Hello to whoever else is in the tube.""" 
logger . debug( ' Running remote play:%s x %s . ' , x, y) 

def add_hello_handler (self ) : 

logger . debug( 'Adding hello handler.') 

self . tube.add_signal_receiver(self . hello_signal_cb, 

'Hello', IFACE, 

path=PATH, sender_keyword= ' sender ' ) 
self. tube. add_signal_receiver ( self . play_signal_cb, 

'Play', IFACE, 

path=PATH, sender_keyword= ' sender ' ) 

def hello_signal_cb(self , sender=None) : 

"""Somebody Helloed me. World them.""" 
if sender == self . tube . get_unique_name( ) : 

# sender is my bus name, so ignore my own signal 
return 

logger . debug( ' Newcomer %s has joined', sender) 
logger . debug( 

'Welcoming newcomer and sending them ' 

' the game state ' ) 

self. other = sender 

# I send my ships and I get theirs in return 
enemy_boats = self . tube . get_object(self. other, 

PATH) .World( 

self .my_boats, dbus_interface=IFACE) 

# I call the callback World, to load the enemy ships 
self .World_cb(enemy_boats) 

def play_signal_cb(self , x, y, sender=None) : 
"""Somebody placed a stone. """ 
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if sender == self . tube . get_unique_name( ) : 

return # sender is my bus name, 
# so ignore my own signal 
logger . debug( ' Buddy %s placed a stone at %s x %s ' , 

sender, x, y) 

# Call our Play callback 
self . Play_cb(x, y) 

# In theory, no matter who sent him 

def _list_tubes_error_cb(self , e): 

logger . error (' ListTubes( ) failed: %s ' , e) 

def _list_tubes_reply_cb(self , tubes): 
for tube_info in tubes: 

self ._new_tube_cb(*tube_info) 

def _new_tube_cb(self , id, initiator, type, 
service, params, state): 

logger . debug( ' New tube: ID=%d initator=%d ' 
'type=%d service=%s ' 

'params=%r state=%d', id, initiator, ' 
'type, service, params, state) 
if (type == telepathy. TUBE_TYPE_DBUS and 
service == SERVICE) : 

if state == telepathy. TUBE_STATE_LOCAL_PENDING: 
self .tubes_chan[ telepathy. CHANNEL_TYPE_TUBES] 
.AcceptDBusTube(id) 
self. tube = SugarTubeConnection(self .conn, 

self .tubes_chan[ telepathy. CHANNEL_TYPE_TUBES], 
id, group_iface= 

self . text_chan [telepathy . \ 

CHANNEL_INTERFACE_GROUP] ) 
super(CollaborationWrapper, 

self). init (self. tube, PATH) 

self. tube .watch_participants( 
self. participant_change_cb) 

def _buddy_joined_cb (self, activity, buddy): 
"""Called when a buddy joins the shared 
activity. """ 
logger . debug( 

'Buddy %s joined', buddy . props . nick) 
if self . buddy_joined : 

self . buddy_joined( buddy) 

def _buddy_lef t_cb (self, activity, buddy): 
"""Called when a buddy leaves the shared 
activity. """ 
if self . buddy_lef t : 

self . buddy_left( buddy) 

def _get_buddy(self , cs_handle) : 

"""Get a Buddy from a channel specific handle.""" 
logger . debug( 'Trying to find owner of handle %u . . . ' , 

cs_handle) 
group = self . text_chan[telepathy .\ 

CHANNEL_INTERFACE_GROUP] 
my_csh = group .GetSelfHandle( ) 
logger . debug( 
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'My handle in that group is %u ' , my_csh) 
if my_csh == cs_handle: 

handle = self . conn .GetSelfHandle( ) 

logger . debug( 'CS handle %u belongs to me, %u ' , 
cs_handle, handle) 
elif group . GetGroupFlags( ) & \ 

telepathy. \ 

CHANNEL_GROUP_FLAG_CHANNEL_SPECIFIC_HANDLES: 

handle = group . GetHandleOwners( [cs_handle] ) [0] 

logger . debug( 'OS handle %u belongs to %u ' , 
cs_handle, handle) 
else : 

handle = cs_handle 

logger . debug( ' non-CS handle %u belongs to itself, 
handle) 

# XXX: deal with failure to get the handle owner 

assert handle != 
return self . presence_service A 

get_buddy_by_telepathy_handle( 

self . conn . service_name, 

self . conn . object_path, handle) 

La mayor parte del codigo de arriba es similar a lo que se ha visto en 
otros ejemplos, y la mayor parte de este puede ser usado tal cual en 
cualquier Actividad que necesite hacer llamadas D-Bus. Por esta razon 
vamos a enfocarnos en el codigo que especificamente utiliza D-Bus. El 
punto logico de inicio es el metodo Hello(). Por supuesto no existe nada 
magico en el nombre "Hello". Hello Mesh intenta ser un "Hola Mundo" 
(Hello World) usando Tuberias D-Bus, entonces por convencion las 
palabras "Hola" (Hello) y "Mundo"(World) tendran que ser usadas. El 
metodo HelloO es enviado a todas las instancias de la Actividad para 
informarles que una nueva instancia de la misma esta lista para recibir 
informacion del estado de la Actividad compartida. Tu Actividad 
probablemente necesitara algo similar, pero sientete libre de nombrarlo 
de otra forma, y si estas escribiendo codigo para alguna tarea 
definitivamente deberias darles otro nombre: 

# This is sent to all participants whenever we 

# join an activity 

§signal(dbus_interf ace=IFACE, signature=' ' ) 
def Hello(self ) : 

"""Say Hello to whoever else is in the tube.""" 
logger . debug( ' I said Hello.') 

def add_hello_handler (self ) : 

logger . debug( 'Adding hello handler.') 
self . tube.add_signal_receiver( 
self . hello_signal_cb, 
'Hello', IFACE, 
path=PATH, sender_keyword= ' sender ' ) 
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def hello_signal_cb(self , sender=None) : 
"""Somebody Helloed me. World them, 
if sender == self . tube . get_unique_name( ) 
# sender is my bus name, 
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# so ignore my own signal 

return 
logger . debug( ' Newcomer %s has joined', sender) 
logger . debug( 

'Welcoming newcomer and sending them ' 

' the game state ' ) 

self. other = sender 

# I send my ships and I returned theirs 
enemy_boats = self . tube . get_object( 

self. other, PATH).World( 

self .my_boats, dbus_interface=IFACE) 

# I call the callback World, to load the enemy ships 
self .World_cb(enemy_boats) 

Lo mas interesante en este codigo es la siguiente linea en la cual Python 
invoca a un Decorator (Decorator es una forma avanzada de realizar 
herencia en Python): 

§signal(dbus_interface=IFACE, signature=' ' ) 

Cuando insertas ©signal delante del nombre de un metodo causa el 
efecto de agregar los dos parametros mostrados a la llamada al metodo 
siempre que es invocado, es decir cambia una llamada regular de un 
metodo por una llamada a una sehal D-Bus. El parametro signature es 
una cadena vacia que indica que esta invocacion al metodo no tiene 
ningun parametro. El metodo HelloO no hace nada cuando se ejecuta 
localmente, pero cuando es recibido por otras instancias de la Actividad 
hace que se ejecute el metodo WorldO, quien envia la posicion de sus 
barcos y recibe la posicion de los barcos de los nuevos participantes 
como respuesta. 

Batalla Naval aparentemente es un programa demostrativo. Es un 
juego de dos jugadores, pero en el codigo no existe nada que impida que 
mas jugadores se unan al juego y no hay forma de controlarlos si lo 
hacen. Idealmente deberia ser posible que solo el primer jugador que se 
une a la Actividad y quien inicio la Actividad participen del juego y hacer 
que el resto de los participantes que se unen a la Actividad sean 
solamente espectadores. 

Ahora veremos como esta hecho el metodo World(): 

# This is called by whoever receives our Hello signal 

# This method receives the current game state and 

# puts us in sync with the rest of the participants. 

# The current game state is represented by the game 

# object 

§method(dbus_interface=IFACE, in_signature= ' a(ssiii) ' , 

out_signature='a(ssiii) ' ) 
def World(self, boats): 

"""To be called on the incoming XO after 

they Hello.""" 

if not self. world: 
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logger . debug( 'Somebody called World on me') 

self. world = True # Instead of loading the world, 

# I am receiving play by play. 

self . Wo rld_cb( boats) 

# now I can World others 

self . add_hello_handler( ) 
else : 

self. world = True 

logger . debug( "I 've already been welcomed, " 
"doing nothing") 
return self .my_boats 

Aqui se muestra otro decorador (decorator), este convierte el metodo 
WorldO en una invocacion a un metodo D-Bus. La firma (signature) es 
mas interesante que la del metodo Hello(). Esta define una llamada a 
un conjunto (array) de tuplas donde cada tupla esta compuesta por dos 
cadenas y tres enteros. Cada elemento en el array representa una barco 
y sus atributos. World_cb apunta a un metodo en BatallaNaval.py, (y 
tambien lo hace Play_cb). Si estudias el codigo de init() en 
BatallaNaval.py podras ver como sucede esto. WorldO es invocado 
desde el metodo hello_slgnal_cb() que acabamos de ver. Este es 
enviado a quien se une a la Actividad que nos envio anteriormente 
HelloO a nosotros. 

Finalmente veremos la serial PlayO: 

§signal(dbus_interf ace=IFACE, signature='ii' ) 

def Play(self, x, y) : 

"""Say Hello to whoever else is in the tube.""" 
logger . debug( ' Running remote play:%s x %s . ' , x, y) 

def add_hello_handler (self ) : 

self . tube.add_signal_receiver(self . play_signal_cb, 
'Play', IFACE, 
path=PATH, sender_keyword= ' sender ' ) 

def play_signal_cb(self , x, y, sender=None) : 
"""Somebody placed a stone. """ 
if sender == self . tube . get_unique_name( ) : 
return # sender is my bus name, so 
# ignore my own signal 
logger . debug( ' Buddy %s placed a stone at %s x %s ' , 

sender, x, y) 
# Call our Play callback 
self . Play_cb(x, y) 

Esta es una serial por lo que solamente se tiene una cadena firma, esta 
indica que los parametros de entrada son dos enteros. 
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Existen muchas formas de mejorar esta Actividad. Cuando se juega 
contra la computadora en modo no-compartido el juego solo hace 
jugadas al azar (es decir cuando se juega contra la computadora no se 
hace uso de intelingencia artificial, caracteristica fundamental de 
cualquier juego). El juego no limita el numero de jugadores a dos, ni 
hace del resto espectadores del juego. No controla que los participantes 
ejecuten sus jugadas por turnos. Cuando un jugador termina de hundir 
todas las embarcaciones de su oponente no sucede nada que nos avise 
que ganamos la partida. Finalmente no se hace uso de gettextO para 
las cadenas de texto que se muestran en la Actividad lo que significa que 
esta no podria ser traducido a otros idiomas que no sea espahol. 

Como es tradicion en cualquier libro, dejare que la realizacion de estas 
mejoras sea un ejercicio para el estudiante. 



1. Traducido Vladimir Castro, Bolivia. 
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J. O • Agregar texto hablado 



Introduccion 

Ciertamente una de las Actividades disponibles mas populares es Speak 
(Hablar), la cual toma las palabras que tecleas y las pronuncia en voz 
alta, mostrando al mismo tiempo una carita que parece hablar. Te 
puedes sorprender al saber que poco codigo de esa Actividad se requiere 
utilizar para lograr pronunciar las palabras. Si tu Actividad se puede 
beneficiar al pronunciar palabras en voz alta (hay posibilidades para 
Actividades educativas y en juegos) este capitulo te ensehara como 
hacer que eso suceda. 




Hello everyone! 



J 



Tenemos maneras de hacerte hablar 

Un par de maneras y ambas faciles son: 

• Correr el programa espeak directamente 

• Usar el plugin gstreamer espeak 
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Am bos metodos tienen sus ventajas. El primero es usar Speak 
(tecnicamente Speak usa el plugin gstreamer si esta disponible y si no lo 
esta ejecuta directamente espeak. Para lo que hace Speak, el plugin 
gstreamer no es realmente necesario). Ejecutar espeak es claramente 
el metodo mas simple y puede ser apropiado para tu Actividad. Su gran 
ventaja es que no tienes que tener el plugin gstreamer instalado. Si tu 
Actividad necesita correr en otra que la ultima version de Sugar, esto 
puede ser algo para considerar. 

El plugin gstreamer es lo que usa Read Etexts para hacer texto hablado 
con resaltador. Para esta aplicacion necesitamos ser capaces de hacer 
cosas que no son posibles solamente corriendo espeak. Por ejempio: 

• Necesitamos parar y retomar el habia, ya que la Actividad necesita 
leer una pagina completa, no solamente frases simples. 

• Necesitamos resaltar las palabras a medida que son pronunciadas. 

Tu puedes pensar que puedes lograr estos objetivos corriendo espeak de 
a una palabra por vez. Si lo piensas, no te sientas mal porque yo 
tambien pense eso. En una computadora rapida suena horrible, como 
HAL 9000 tartamudeando al final, antes de ser desactivada. En la XO no 
sale sonido alguno. 

Originalmente Read Etexts uso speech-dispatcher para hacer lo que 
hace el plugin gstreamer. Los desarrolladores del ese programa fueron 
de mucha ayuda para lograr funcionar el resaltador en Read Etexts, pero 
speech-dispatcher necesita ser configurado antes de poder usarlo, lo que 
fue un problema para nosotros. (Hay mas de un tipo de software 
disponible para convertir texto en habIa y speech-dispatcher soporta la 
mayoria de ellos. Esto hace inevitable tener archivos de configuracion). 
Aleksey Lim de los laboratorios de Sugar tuvo la idea de usar el plugin de 
gstreamer y fue quien lo escribio. El tambien reescribio gran parte de 
Read Etexts de forma que use el plugin si esta disponible, use speech- 
dispatcher si no, y no soporte hablar si ninguno de los dos esta 
disponible. 



Correr espeak directamente 



Tu puedes correr el programa espeak desde la terminal para probar sus 
opciones. Para ver que opciones estan disponibles para espeak tu puedes 
usar el comando man: 

man espeak 

Esto te trae una pagina del manual donde se describe como correr el 
programa y que opciones hay disponibles. Las partes de la pagina man 
que nos interesan mas son las siguientes: 

NAME 

espeak - A multi-lingual software speech synthesizer. 
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SYNOPSIS 

espeak [options] [<words>] 

DESCRIPTION 

espeak is a software speech synthesizer for English, 
and some other languages. 

OPTIONS 

-p <integer> 

Pitch adjustment, to 99, default is 50 

-s <integer> 

Speed in words per minute, default is 160 

-V <voice name> 

Use voice file of this name from 
espeak-dat a/ voices 

- -voices[=<language code>] 

Lists the available voices. If =<language code> 
is present then only those voices which are 
suitable for that language are listed. 

Probemos algunas de estas opciones. Primero obtengamos una lista de 
voces (Voices): 

espeak --voices 

Pty Language Age/Gender VoiceName 

5 af M afrikaans 

5 bs M bosnian 

5 ca M Catalan 

5 cs M Czech 

5 cy M welsh-test 

5 de M german 

5 el M greek 

5 en M default 

5 en-sc M en-scottish 

2 en-uk M english 

. . . and many more . . . 

Ahora que sabemos los nombres de las voces podemos probarlas. iQue 
tal ingles con acento frances? 

espeak "Your mother was a hamster and your father \ 
smelled of elderberries." -v fr 

Experimentemos con velociadad y tono (rate and pitch): 

espeak "I'm sorry, Dave. I'm afraid I can't \ 
do that. " -s 120 -p 30 

Lo siguiente es escribir algo de codigo Python para correr espeak. Aca 
va un pequeho programa adaptado del codigo en Speak: 

import re 

import subprocess 
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File 


Other Langs 


af 




bs 




ca 




cs 




cy 




de 




el 




default 




en/en-sc 


(en 4) 


en/en 


(en 2) 



PITCH_MAX = 99 
RATE_MAX =99 

PITCH_DEFAULT = PITCH_MAX/2 
RATE_DEFAULT = RATE_MAX/3 

def speak(text, rate=RATE_DEFAULT, pitch=PITCH_DEFAULT, 
voice="default" ) : 

# espeak uses 80 to 370 

rate = 80 + (370-80) * int(rate) / 100 

subprocess . call( ["espeak", "-p", str(pitch), 
"-s", str(rate), "-v", voice, text], 
stdout=subprocess.PIPE) 

def voices( ) : 
out = [] 

result = subprocess . Popen( ["espeak", "--voices"], 
stdout=subprocess.PIPE) . communicate ( ) [0] 

for line in result . split (' \n ') : 
m = re.match( 

r'\s*\d+\s+([\w-]+)\s+([MF])\s+([\w_-]+)\s+(.+) ', 

line) 
if not m: 

continue 
language, gender, name, stuff = m.groups() 
if stuff . startswith( 'mb/ ' ) or \ 

name in ( ' en-rhotic ' , ' english_rp ' , 
' english_wmids ' ) : 

# these voices don't produce sound 

continue 
out . append( (language, name)) 

return out 

def main( ) : 

print voices() 

speak("I'm afraid I can't do that, Dave.") 
speak("Your mother was a hamster, and your father " 
+ "smelled of elderberries!", 30, 60, "fr") 

if name == " main " : 

main( ) 

En el repositorio Git del directorio Adding_TTS este archivo se llama 
espeak.py. Cargar este archivo en Eric y ejecutar Run Script desde el 
menu de Start (Inicio). Ademas de escuchar hablar deberias ver este 
texto: 
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[(•af, •afrikaans'), Cbs\ •bosniarT), fca', 'Catalan'), Ccs\ 'czech'), Ccy', 'welsh- 
test), Cde', 'german'), ('el', 'greek'), ('en', 'default'), ('en-sc', 'en-scottish'), 
('en-uk', 'english'), ('en-uk-north', 'lancashire'), ('en-us', 'english-us'), ('en- 
wi', 'en-westindies'). Ceo', 'esperanto'), ('es', 'Spanish'), ('es-la', 'spanish- 
latin-american'), ('fi', 'finnish'), ('fr', 'french'), ('fr-be', 'french'), ('grc', 'greek- 
ancient'), ('hi', 'hindi-test'), ('hr', 'Croatian'), ('hu', 'hungarian'), ('hy', 
'armenian'), ('hy', 'armenian-west'), ('id', 'Indonesian-test'), ('is', 'Icelandic- 
test'), ('it', 'Italian'), ('ku', 'kurdish'), ('la', 'latin'), ('Iv', 'latvian'), ('mk', 
'macedonian-test'), ('nl', 'dutch-test'), ('no', 'norwegian-test'), ('pi', 'polish'), 
Cpt', 'brazil'), Cpt-pt', 'portugal'), ('ro', 'romanian'), ('ru', 'russian_test'), ('sk', 
'Slovak'), ('sq', 'albanian'), ('sr', 'Serbian'), ('sv', 'Swedish'), ('sw', 'swahihi- 
test'), eta', 'tamil'), ('tr', 'turkish'), ('vi', 'vietnam-test'), ('zh', 'Mandarin'), 
('zh-yue', 'cantonese-test')] 

La funcion voicesQ devuelve una lista de voces como una tupla por voz y 
elimina voces de la lista que espeak no puede producir solo. Esta lista 
de tuplas puede ser usada para llenar un menu derivado. 

La funcion speakQ ajusta el valor de la velocidad (rate) para que puedas 
ingresar un valor entre y 99 en lugar de entre 80 y 370. speakQ es 
mas compleja en la Actividad Speak que lo que tenemos aca, porque en 
esa Actividad controla el audio hablado y genera movimientos de la boca 
basados en la amplitud de la voz. Realizar los movimientos de la cara es 
gran parte de lo que hace la Actividad Speak y como no estamos 
haciendo eso, precisamos muy poco codigo para que nuestra Actividad 
hable. 

Tu puedes usar import espeak para incluir este archivo en tus propias 
Actividades. 

Usar el plugin gstr earner espeak 

El plugin gstreamer espeak puede instalarse en Fedora 10 o posterior 
usando Add/Remove Software. 
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Cuando hayas realizado esto debes ser capaz de bajar la Actividad Read 
Etexts (la autentica, no la version simplificada que estamos usando en 
este libro) de ASLO y probar la pestana Speech. Debes hacerlo ahora. Se 
debe parecer a algo asi: 



Is only a record of a plc-nic, it has a purpose, which Is to suggest to 
the Header how he would be likely to see Europe and the East^j he looked 
at them with his own eyes Instead of the eyes of those who traueied in 
those countries before him. I make small pnetense of showing anyone how 
he ought to look at objects of interest beyond the sea— other books do 
that, and therefore, even if I were competent to do it, there is no need. 

I offer no apologies for any departures from the usual style of 
travel-writing that may be charged against me— for I think I have seen with 
Impartial eyes, and I am sure I haue written at least honestly, whether 
wisely or not. 

In this volume I have used portions of letters which I wrote for the 
Daily Alta California, of San Francisco, the proprietors of that journal 
having waived their rights and given me the necessary permission. I have 
aiso inserted portions of several letters written for the New York 
Tribune and the New York Herald, 

THE AUTHOR. 
SAN FRANCISCO, 



El libro usado para las capturas de pantalla anteriores en este manual 
fue Pride and Prejudice de Jane Austen. Para balancear, el resto de las 
capturas de pantalla se haran usando Tlie innocents Abroad de Mark 
Twain. 1 
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Gstreamer es el marco para multimedia. Si has observado videos en la 
web debes estar familiarizado con el concepto de streaming media. En 
lugar de bajar una cancion completa o un vidoe clip completo y luego 
ejecutarlo, streaming significa que la bajada y la ejecucion ocurren al 
mismo tiempo, con la ejecucion un poco detras de la bajada. Hay 
muchos tipos diferentes de archivos de medios: MP3's, DivX, WMV, Real 
Media, y otros. Por cada tipo de archivo de medios Gstreamer tiene un 
plugin. 

Gstreamer utiliza un concepto llamado pipelining. La idea es que la 
salida de un programa puede ser la entrada para otro. Una forma de 
manejar la situacion es poner la salida del primer programa en un 
archivo temporario y hacer que el segundo programa lo lea. Esto 
significa que el primer programa debe terminar de ejecutar antes que el 
segundo pueda empezar. IQue sucederia si los dos programas corren al 
mismo tiempo y que el segundo lea la informacion a medida que el 
primero la escribe? Es posible y el mecanismo para pasar informacion de 
un programa a otro se le llama pipe (caho). A una coleccion de 
programas que se unen de esta manera se les llama un pipeline 
(caheria). Al programa que alimenta la informacion en el caho se le 
llama source (fuente) y al programa que saca los datos del caho se le 
llama sink (pileta). 

El plugin gstreamer espeak usa un caho simple: el texto va a espeak por 
una punta y el sonido sale por el otro y se envia a tu adaptador de 
sonido. Puedes pensar que no suena muy diferente de lo que haciamos 
antes, pero lo es. Cuando corres espeak, el programa se carga en 
memoria, habia el texto que le pasas en la tarjeta de sonido y se 
descarga. Esta es una de las razones por la cuales no puedes usar 
espeak una palabra a la vez para lograr habIa con palabras resaltadas. 
Hay un pequeho retraso mientras el programa se carga. No se nota 
tanto si le pasas a espeak una frase o una oracion completa para leer, 
pero si ocurre para cada palabra es muy notorio. Al usar el plugin 
gstreamer podemos tener espeak cargado en la memoria todo el 
tiempo, esperando que le enviemos algunas palabras a su caho de 
entrada. Las va a decir en voz alta y luego espera por el proximo lote. 

Como podemos controlar lo que entra en el caho, es posible parar y 
retomar el habla. 

El ejempio que usaremos aca es nuevamente la version de Read Etexts, 
pero en lugar de la Actividad vamos a modificar la version autonoma. No 
hay nada especial sobre el plugin gstreamer que lo haga funcionar 
solamente con Actividades. Cualquier programa Python lo puede usar. 
Estoy incluyendo texto hablado como un tema en este manual porque 
cada instalacion Sugar incluye espeak y muchas Actividades pueden 
encontrarlo util. 

En el repositorio Git esta el archivo speech. py que luce asi: 
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import gst 

voice = 'default' 
pitch = 

rate = -20 
highlight_cb = None 

def _create_pipe( ) : 

pipeline = 'espeak name=source ! autoaudiosink ' 
pipe = gst . parse_launch(pipeline) 

def stop_cb(bus, message): 

pipe . set_state(gst . STATE_NULL) 

def mark_cb(bus, message): 

if message . structure. get_name( ) == ' espeak-mark ' 
mark = message . structure[ ' mark ' ] 
highlight_cb(int (mark) ) 

bus = pipe . get_bus( ) 

bus . add_signal_watch( ) 

bus. connect( 'message: :eos', stop_cb) 

bus. connect( 'message: :error', stop_cb) 

bus. connect( 'message: :element', mark_cb) 

return (pipe . get_by_name( ' source ') , pipe) 

def _speech(source, pipe, words): 
source . props . pitch = pitch 
source . props . rate = rate 
source . props .voice = voice 
source . props . text = words; 
pipe. set_st ate (gst .STATE_PLAYING) 

info_source, info_pipe = _create_pipe( ) 
play_source, play_pipe = _create_pipe( ) 

# track for marks 
play_source . props . track = 2 

def voices( ) : 

return info_source . props .voices 

def say(words) : 

_speech(info_source, info_pipe, words) 
print words 

def play(words) : 

_speech(play_source, play_pipe, words) 

def is_stopped( ) : 

for i in play_pipe . get_state( ) : 

if isinstance(i, gst. State) and \ 
i == gst .STATE_NULL: 
return True 
return False 

def stop( ) : 
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play_pipe. set_state(gst .STATE_NULL) 

def is_paused( ) : 

for i in play_pipe. get_state( ) : 

if isinstance(i, gst. State) and \ 
i == gst .STATE_PAUSED: 
return True 
return False 

def pause( ) : 

play_pipe. set_state(gst .STATE_PAUSED) 

def rate_up( ) : 
global rate 
rate = min(99, rate + 10) 

def rate_down( ) : 
global rate 
rate = max(-99, rate - 10) 

def pitch_up( ) : 
global pitch 
pitch = min(99, pitch + 10) 

def pitch_down( ) : 
global pitch 
pitch = max(-99, pitch - 10) 

def prepare_highlighting(label_text) : 
i = 
j = 

word_begin = 
word_end = 
current_word = 
word_tuples = [] 
omitted = [' ', '\n', u'\r', '_', '[', '{', ']',\ 

'}', 'I', '<', '>', '*', ' + ', '/', 'W ] 
omitted_chars = set(omitted) 
while i < len(label_text ) : 

if label_text [i] not in omitted_chars : 
word_begin = i 

J = i 

while j < len(label_text ) and \ 

label_text [ j ] not in omitted_chars : 

j = j + 1 

word_end = j 

i = j 
word_t = (word_begin, word_end, \ 

label_text [word_begin : word_end] . strip( ) ) 
if word_t[2] != u'\r' : 

word_tuples . append ( wo rd_t) 
i = i + 1 
return word_tuples 

def add_word_marks(word_tuples) : 

"Adds a mark between each word of text." 

i = 

marked_up_text = '<speak> ' 

while i < len(word_tuples) : 
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word_t = word_tuples[i] 
marked_up_text = marked_up_text + \ 

'<mark name=" ' + str(i) + '"/>' + word_t[2] 
i = i + 1 
return marked_up_text + '</speak>' 

Hay otro archive llamado ReadEtextsTTS.py que luce asi: 

import sys 

import OS 

import zipfile 

import pygtk 

import gtk 

import getopt 

import pango 

import gobject 

import time 

import speech 

speech_supported = True 

try: 

import gst 

gst .element_factory_make( ' e speak ' ) 

print 'speech supported!' 
except Exception, e: 

speech_supported = False 

print 'speech not supported!' 

page=0 
PAGE_SIZE = 45 

class ReadEtextsActivity( ) : 

def init (self): 

"The entry point to the Activity" 

speech . highlight_cb = self . highlight_next_word 

# print speech .voices( ) 

def highlight_next_word(self , word_count): 
if word_count < len(self .word_tuples) : 

word_tuple = self .word_tuples[word_count] 
textbuffer = self . textview. get_buffer( ) 
tag = textbuffer . create_tag( ) 
tag . set_property( 'weight', pango .WEIGHT_BOLD) 
tag . set_property( 'foreground', "white") 
tag . set_property( 'background', "black") 
iterStart = \ 

textbuffer. get_iter_at_off set(word_tuple[0] ) 
iterEnd = \ 

textbuffer. get_iter_at_off set(word_tuple[l] ) 
bounds = textbuffer . get_bounds( ) 
textbuffer. remove_all_tags( bounds [0] , bounds [1] ) 
textbuffer . apply_tag(tag, iterStart, iterEnd) 
v_adjustment = \ 

self. scrolled_window. get_vadjustment ( ) 
max = v_adjustment . upper - \ 

v_adjustment . page_size 
max = max * word_count 
max = max / len(self . word_tuples) 
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v_adjustment .value = max 
return True 

def keypress_cb(self , widget, event): 

"Respond when the user presses one of the arrow keys" 

global done 

global speech_supported 

keyname = gtk . gdk. keyval_name(event . keyval) 

if keyname == 'KP_End' and speech_supportecl : 

if speech . is_paused( ) or speech . is_stopped( ) : 
speech. play (self .words_on_page) 

else : 

speech . pause( ) 

return True 
if keyname == 'plus': 

self . font_increase( ) 

return True 
if keyname == 'minus': 

self . font_decrease( ) 

return True 
if speech_supported and speech . is_stopped( ) == False \ 

and speech . is_paused == False: 

# If speech is in progress, ignore other keys. 

return True 
if keyname == ' 7 ' : 

speech . pitch_down( ) 

speech . say( ' Pitch Adjusted') 

return True 
if keyname == ' 8 ' : 

speech . pitch_up( ) 

speech . say( ' Pitch Adjusted') 

return True 
if keyname == ' 9 ' : 

speech . rate_down( ) 

speech . say( ' Rate Adjusted') 

return True 
if keyname == '0 ' : 

speech . rate_up( ) 

speech . say( ' Rate Adjusted') 

return True 
if keyname == 'KP_Right': 

self . page_next( ) 

return True 
if keyname == 'Page_Up' or keyname == 'KP_Up': 

self . page_previous( ) 

return True 
if keyname == 'KP_Left': 

self . page_previous( ) 

return True 
if keyname == 'Page_Down' or keyname == ' KP_Down ' : 

self . page_next( ) 

return True 
if keyname == ' Up ' : 

self . scroll_up( ) 

return True 
if keyname == ' Down ' : 

self . scroll_down( ) 

return True 
return False 
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def page_previous(self ) : 
global page 
page=page-l 
if page < 0: page=0 
self. show_page(page) 
v_adjustment = \ 

self . scrolled_window. get_vad just men t( ) 
v_adjustment .value = v_adjustment . upper - \ 

v_adjustment . page_size 

def page_next (self ) : 
global page 
page=page+l 

if page >= len(self . page_index) : page=0 
self. show_page(page) 
v_adjustment = \ 

self . scrolled_window. get_vadjustment( ) 
v_adjustment .value = v_adjustment . lower 

def font_decrease(self ) : 

font_size = self . font_desc . get_size( ) / 1024 
font_size = font_size - 1 
if font_size < 1: 
font_size = 1 
self .font_desc . set_size(font_size * 1024) 
self. text view. modify_font (self . f ont_desc) 

def font_increase(self ) : 

font_size = self . font_desc . get_size( ) / 1024 
font_size = font_size + 1 
self .font_desc . set_size(font_size * 1024) 
self. text view. modify_font (self . f ont_desc) 

def scroll_down(self ) : 
v_adjustment = \ 

self . scrolled_window. get_vad just men t( ) 
if v_adjustment .value == v_adjustment . upper - 
v_adjustment . page_size: 
self . page_next( ) 
return 
if v_adjustment . value < v_adjustment . upper - 
v_adjustment . page_size: 
new_value = v_adjustment .value + \ 

v_adjustment . step_increment 
if new_value > v_adjustment . upper - \ 
v_adjustment . page_size : 
new_value = v_adjustment . upper - \ 
v_adjustment . page_size 
v_adjustment .value = new_value 

def scroll_up(self ) : 
v_adjustment = \ 

self . scrolled_window. get_vad just men t( ) 
if v_adjustment .value == v_adjustment . lower : 

self . page_previous( ) 

return 
if v_adjustment .value > v_adjustment . lower : 

new_value = v_adjustment .value - \ 
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v_adjustment . step_increment 
if new_value < v_adjustment . lower : 

new_value = v_adjustment . lower 
v_adjustment .value = new_value 

def show_page(self , page_number) : 
global PAGE_SIZE, current_word 
position = self . page_index[page_number] 
self . etext_file .seek(position) 
linecount = 
label_text = ' ' 

textbuffer = self . textview. get_buffer( ) 
while linecount < PAGE_SIZE: 

line = self .etext_file . readline( ) 

label_text = label_text + \ 

unicode(line, ' iso-8859-1 ' ) 

linecount = linecount + 1 
textbuffer. set_text(label_text ) 
self. textview. set_buffer( textbuffer) 
self .word_tuples = \ 

speech . prepare_highlighting(label_text ) 
self .words_on_page = \ 

speech . add_word_marks(self .word_tuples) 

def save_extracted_file(self , zipfile, filename): 

"Extract the file to a temp directory for viewing" 
filebytes = zipfile . read(filename) 
f = open("/tmp/" + filename, 'w') 
try: 

f.write(filebytes) 
finally: 

f . close( ) 

def read_file(self , filename): 
"Read the Etext file" 
global PAGE_SIZE 

if zipfile . is_zipfile(f ilename) : 

self.zf = zipfile .ZipFile(filename, 'r') 
self . book_f iles = self .zf . namelist( ) 
self . save_extracted_file(self . zf , \ 

self .book_f iles [0] ) 
currentFileName = "/tmp/" + self . book_f iles[0] 

else : 

currentFileName = filename 

self .etext_file = open(currentFileName, "r") 

self . page_index = [ ] 

linecount = 

while self . etext_f ile : 

line = self .etext_file . readline( ) 
if not line: 

break 
linecount = linecount + 1 
if linecount >= PAGE_SIZE: 

position = self .etext_file. tell( ) 
self. page_index. append (posit ion) 
linecount = 
if filename . endswith( ". zip" ) : 
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os.remove(currentFileName) 

def delete_cb(self , widget, event, data=None) : 
speech . stop( ) 
return False 

def destroy_cb(self , widget, data=None): 
speech . stop( ) 
gtk .main_quit( ) 

def main(self, file_path): 

self. window = gtk .Window(gtk.WINDOW_TOPLEVEL) 
self.window.connect( "delete_event", self .delete_cb) 
self.window.connect( "destroy", self. destroy_cb) 
self .window. set_title( "Read Etexts Activity") 
self .window. set_size_request (800, 600) 
self .window. set_border_width(0) 
self. read_file(f ile_path) 
self . scrolled_window = gtk.ScrolledWindow( 

hadjustment=None, vadjustment=None) 
self . textview = gtk .TextView( ) 
self. textview. set_editable(False) 
self. textview. set_lef t_margin(50) 
self. textview. set_cur so r_visible( False) 
self. textview. connect ( "key_p res s_e vent", 

self . keypress_cb) 
self .font_desc = pango . FontDescription( "sans 12") 
self. textview. modify_font (self . f ont_desc) 
self. show_page(0) 

self. scrolled_window. ad d(self. textview) 
self.window.add(self. scrolled_window) 
self. textview. show( ) 
self. scrolled_window. show( ) 
self .window. show ( ) 
gtk .main( ) 

if name == " main " : 

try: 

opts, args = getopt . getopt(sys . argv[l: ] , "") 

ReadEtextsActivity( ) . main ( args [0] ) 
except getopt . error, msg: 

print msg 

print "This program has no options" 

sys . exit(2) 

El programa ReadEtextsTTS tiene solamente unos pocos cambios para 
habilitarlo para hablar. El primero verifica la existencia del plugin 
gstreamer: 

speech_supported = True 

try: 

import gst 

gst .element_factory_make( 'espeak ' ) 

print 'speech supported!' 
except Exception, e: 

speech_supported = False 

print 'speech not supported!' 
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Este codigo detecta si el plugin esta instalado intentando importar de las 
librerias de Python la llamada "gst". Si la importacion falla arroja una 
Exception (excepcion) y capturamos la Exception y la usamos para 
establecer una variable llamada speech_supported a False (falso). 
Podemos verificar el valor de la variable en otras partes del programa 
para que el programa trabaje con texto hablado si esta disponible y sin 
el, si no lo esta. Hacer que un programa trabaje en ambientes diferentes 
haciendo este tipo de chequeos se le llama "degradacion elegante" 
(degrading gracefully). Procesar excepciones en las importaciones es 
una tecnica habitual en Python para lograr esto, Si quieres que tu 
Actividad corra con versiones anteriores de Sugar puedes llegar a 
usarlo. 

El siguiente trozo de codigo que vamos a analizar resalta una palabra en 
el area de visualizacion del texto y lo pagina para mantener visible la 
palabra resaltada. 

class ReadEtextsActivity( ) : 

def init (self): 

"The entry point to the Activity" 

speech . highlight_cb = self . highlight_next_word 

# print speech .voices( ) 

def highlight_next_word(self , word_count): 
if word_count < len(self .word_tuples) : 

word_tuple = self .word_tuples[word_count] 
textbuffer = self . textview. get_buffer( ) 
tag = textbuffer .create_tag( ) 
tag.set_property( 'weight', pango.WEIGHT_BOLD) 
tag . set_property( 'foreground', "white") 
tag . set_property( 'background', "black") 
iterStart = \ 

textbuffer .get_iter_at_off set(word_tuple[0] ) 
iterEnd = \ 

textbuffer .get_iter_at_off set(word_tuple[l] ) 
bounds = textbuffer . get_bounds( ) 
textbuffer. remove_all_tags( bounds [0] , bounds [1] ) 
textbuffer . apply_tag(tag, iterStart, iterEnd) 
v_adjustment = \ 

self. scrolled_window. get_vadjustment ( ) 
max = v_adjustment . upper - v_adjustment . page_size 
max = max * word_count 
max = max / len(self .word_tuples) 
v_adjustment .value = max 
return True 

En el metodo init () asignamos una variable llamada higlilight_cb en 

speech. py con un metodo llamado liiglilight_next_word(). Esto le da a 
speech. py una forma de llamar a ese metodo cada vez que una nueva 
palabra en el area de texto debe ser resaltada. 
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Si le quitas el comentario a la siguiente linea, se imprime a la terminal 
la lista de tuplas conteniendo los nombres de las voces. No estamos 
permitiendo que el usuario cambie las voces en esta aplicacion, pero no 
seria dificil agregar esa caracteristica. 

A continuacion el codigo para el metodo para resaltar las palabras. Lo 
que hace es mirar en la lista de tuplas que contienen la posicion inicial y 
final de cada palabra (offsets) en el buffer de texto del area de texto. El 
que llama a este metodo pasa el numero de una palabra (por ejempio la 
primer palabra en el buffer es la palabra 0, la segunda es la palabra 1 y 
asi sucesivamente). Este metodo busca esa entrada en la lista, obtiene 
sus posiciones de inicio y fin, elimina cualquier resaltado anterior y 
resalta el nuevo texto. Adicionalmente determina que fraccion es del 
total de palabras y desplaza el area de texto lo suficiente para 
asegurarse que la palabra este visible. 

Por supuesto este metodo funciona mejor en paginas sin demasiadas 
lineas en bianco, que por suerte son la mayoria. No funciona tan bien en 
caratulas. Un programador con experiencia seguramente defina una 
forma mas elegante y confiable para hacer este paginado. Avisenme si 
definen algo. 

Mas abajo vemos el codigo que reel be caracteres del teclado del usuario 
y hace cosas relacionadas con el habia con ellos: 

def keypress_cb(self , widget, event): 

"Respond when the user presses one of the arrow keys" 

global done 

global speech_supported 

keyname = gtk . gdk . keyval_name(event . keyval) 

if keyname == 'KP_End' and speech_supported : 

if speech . is_paused( ) or speech . is_stopped( ) : 
speech. play (self .words_on_page) 

else : 

speech . pause( ) 

return True 
if speech_supported and speech . is_stopped( ) == False \ 

and speech . is_paused == False: 

# If speech is in progress, ignore other keys. 

return True 
if keyname == ' 7 ' : 

speech . pitch_down( ) 

speech . say( ' Pitch Adjusted') 

return True 
if keyname == ' 8 ' : 

speech . pitch_up( ) 

speech . say( ' Pitch Adjusted') 

return True 
if keyname == ' 9 ' : 

speech . rate_down( ) 

speech . say( ' Rate Adjusted') 

return True 
if keyname == '0 ' : 

speech . rate_up( ) 

speech . say( ' Rate Adjusted') 
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return True 

Como puedes ver, las funciones a las que llamamos estan todas en el 
archivo speech. py que importamos. No tienes que entender 
completamente como operan estas funciones para usarlas en tus 
propias Actividades. Nota que como esta escrito el codigo previene al 
uuario de cambiar el tono o la velocidad una vez que se comenzo a 
hablar. Nota tambien que hay dos metodos diferentes en speech. py 
para hablar. playO es el metodo para tener texto hablado con resaltado 
de las palabras. sayO es para decir frases cortas producidas por la 
interfaz de usuario, en este caso con ajuste de tono (Pitch adjusted) y de 
velocidad (Rate adjusted). Por supuesto si pones un codigo como este en 
tu Actividad debes usar la funcion _() de forma que estas frases puedan 
ser traducidas a otros idiomas. 

Hay un poco mas de codigo que precisamos para hacer texto hablado 
con resaltador que: necesitamos preparar las palabras que van a ser 
pronunciadas para resaltarlas en el area de texto. 

def show_page(self , page_number) : 
global PAGE_SIZE, current_word 
position = self . page_index[page_number] 
self .etext_file .seek(position) 
linecount = 
label_text = ' ' 

textbuffer = self . textview.get_buffer( ) 
while linecount < PAGE_SIZE: 

line = self .etext_file . readline( ) 

label_text = label_text + unicode(line, \ 
'iso-8859-1' ) 

linecount = linecount + 1 
textbuffer. set_text(label_text ) 
self.textview. set_buffer( textbuffer) 
self .word_tuples = \ 

speech . prepare_highlighting(label_text ) 
self .words_on_page = \ 

speech . add_word_marks(self .word_tuples) 

El comienzo de este metodo lee una pagina de testo en un string 
llamado label_text y lo coloca en el buffer del area de visualizacion del 
texto. Las ultimas dos lineas separan el texto en palabras, separando la 
puntuacion y colocando cada palabra y sus offsets de posicion de incio y 
de fin en una tupla. Las tuplas se agregan a una lista. 

speech. add _word_marksO convierte las palabras en la lista en un 
documento en formato SSML (Speech Synthesis Markup Language). 

SSML es un estandar para agregar etiquetas (tipo las etiquetas usadas 
para hacer paginas web) al texto para decirle al software de hablar que 
hacer con el texto. Estamos usando una parte muy pequeha de este 
estandar para producir un documento marcado con una marca 
(etiqueta) entre cada palabra, como esto: 

<speak> 
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<mark name="0"/>The<mark name="l"/>quick<mark name-"2"/> 
brown<mark name="3"/>fox<mark name="4"/>jumps 
</speak> 

Cuando espeak lee este archive hace un callback en nuestro programa 
cada vez que lee una de las etiquetas. La llamada (callback) va a 
contener el numero de la palabra en la lista de tuplas (word_tuples) el 
que obtiene del atributo name (nombre) de la etiqueta (mark). De esta 
forma el metodo llamado sabe que palabra resaltar. La ventaja de usar 
el nombre en lugar de solo resaltar la siguiente palabra en el area de 
visualizacion del texto es que si espeak falla al hacer uno de los callback, 
el resaltado no pierde el sincronismo. Esto era un problema con speech- 
dispatcher. 

Un callback es lo que parece ser. Cuando un programa llama a otro le 
puede pasar una funcion o metodo propio que quiere que el segundo 
programa Name si ocurre algo. 

Para probar el nuevo programa ejecuta: 
. /ReadEtextsTTS. py bookfile 

desde la terminal. Puedes ajustar el tono y velocidad hacia arriba y hacia 
abajo usando las teclas 7, 8, 9 y en la linea superior del teclado. Debe 
decir "Pitch Adjusted" o "Rate Adjusted" cuando lo haces. Puedes iniciar, 
parar y retomar el hablar con resaltador usando la tecia End (fin) en el 
teclado. (En la laptop XO las teclas de juego (game) se corresponden con 
el teclado numerico de un teclado normal. Esto hace practico el uso de 
esas teclas cuando la XO esta doblada en modo tablet y el teclado no 
esta disponible). No puedes cambiar el tono o la velocidad cuando hablar 
esta en progreso. Los intentos de hacerlo seran ignorados. El programa 
en accion luce asi: 
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Alexandria, which will be reached in twenty-four hours. The rums 
of Caesar's Palace. Pompey's Pillar. Cleopatra's rjeerfle. the 
Catacombs, and ruir-s of anctent Alexandria wi If be fourd worth the 
yi£it. The jDurney to caira. one liundred and thirty milsE by rail. 
can be made in a ^ew hours, and from which can be visited the site 
Dt ancient Memphis., Joseph's Granaries, and the Pyramids. 

From Alexandr ia Che routre wi3l be taken homeward, calling at 
M^lra^ f^?TTBff| {in Sardinia}, and Palma {in Majorcd)^ ^11 
magnificent harbors, with charming scenery, and abounding in fruits. 

A day or two will be spent at each place, and leaving Parma in the 
evening, Valencia in Spain wiM be reached the next morning. A few 
days will be spent in this. theHhesc city of Spain, 

From Valencia, the home-ward cours.e will he continued,, skirting 
along the coast of Spain. AlKant Carthagena. Palos. and Malaga 
will be passed but a mile or two distant, and Gibraltar reached in 
abbiJC twenty-four hours. 

A stay of one day will be made here, and the voyage continued to 
Madeira, which wril be reached in about three days. Captarn 
Marryatt writes: "I do no!: know a s-pot on the globe which so much 
astonishes and delights upon First arrival as Madeira." A stay of 
one or two days will be made here, which, if time permits, may be 
extended, arid passing on through ther i*ilanris, arid proh;5bly in ^ight 
of the Peak of Teneriffe. a southern track will be take^n, and the 
Atlantic crossed within the latitudes of the northeast trade winds, 
where mild and pleasant weather, and a smooth sea, can always be 
expected. 

A call will be unade at Bermuda, which lies directly in this route 
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Esto nos trae al fin del tema del texto hablado. Si quieres ver mas, el 
repositorio Git para este libro tiene algunos programas ejempio mas que 
usan el plugin gstreamer espeak. Estos ejemplos fueron creados por el 
autor del plugin y muestran otras formas en las que lo puedes usar. Hay 
un programa "coro" que demuestra multiples voces hablando al mismo 
tiempo. 



1. NT: The Innocents Abroad, or The New Pilgrims' Progress o Los 
inocentes en el extranjero es un libro de viajes con cronicas de 
humor de Mark Twain publicado en 1869.— 

2. Traducido Olga Mattos, Uruguay— 
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A / • Jugar con el Journal 

Introduccion 

Por defecto, cada Actividad genera y lee una entrada en el Journal 
(Diario). La mayoria de las Actividades no hace nada mas que esto en 
relacion al Diario, si tu Actividad es de este tipo no necesitaras leer el 
contenido de este capitulo. Sin embargo para el dia en que hagas 
Actividades mas elaboradas, te conviene seguir leyendo. 

Primero repasemos que es el Journal. El Journal, es una coleccion de 
archivos con cierta metadata (data por encima de la data) asociada a 
ellos. La metadata, esta guardada como cadenas de texto y incluye cosas 
como Title, Description, Tags, MIME Type (Titulo, descripcion, 
etiquetas, tipos MIME) y una captura de pantalla del ultimo acceso a la 
Actividad. 

Estos archivos de metadata no son leidos directamente por tu Actividad. 
Sugar provee una Interfaz de Programacion de Aplicaciones ( API 
Application Programming Interface). Esta API proporciona metodos para 
agregar, borrar y modificar entradas del Journal, asi como metodos de 
busqueda y listado de entradas que coincidan con algun criterio. 

En el paquete datastore se encuentra la API que usaremos. Despues de 
la version .82 esta API fue reescrita asi que deberemos aprender como 
hacer para que nuestra Actividad tenga soporte para ambas versiones. 

Si has venido leyendo este libro hasta ahora, ya habras notado mas de 
un caso donde Sugar comienza con un proceder inicial que luego cambia 
para incluir mejoras, pero siempre brinda la opcion de que las 
Actividades elijan trabajar con los metodos viejos. Si te preguntas si es 
normal para un proyecto proceder de esta forma; te digo, como 
programador profesional que los trucos para conservar la retro- 
compatibilidad son archi-comunes, y que Sugar no hace mas trucos que 
los habituales. Cuando Herman Hollerith tabulo el censo de 1890l con 
tarjetas perforadas, tomo decisiones con las que los programadores de 
hoy dia deben lidiar aun. 
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Presentacion del Sugar Commander 

Aunque soy un gran fan del concepto del Journal, no soy muy amigo de 
la Actividad Journal que Sugar usa para navegar el Journal y para 
mantenerlo. Mi mayor queja es que representa el contenido de los 
dispositivos de memoria como pendrives y tarjetas SD, como si estos 
ficheros estuvieran en el Journal. Mi postura es que los archivos y 
ficheros son una cosa, y que el Journal es otra cosa, por lo que la interfaz 
de usuario deberia distinguir bien esto. 

La Actividad Journal no es una Actividad en el sentido estricto. Hereda 
codigo de la clase Activity como cualquier otra Actividad, esta escrita en 
Python y usa la misma datastore API que todas las Actividades. Sin 
embargo, se ejecuta de una forma particular que deriva en permisos y 
habilidades que estan mas alia que los de una Actividad comun. En 
particular hace dos cosas: 

• Puede escribir sobre archivos en dispositivos externos como 
pendrives y tarjetas SD. 

• Puede utilizarse por si sola para retomar entradas del Diario que son 
de uso de otra Actividad. 

Si quisiera escribir una Actividad Journal que hiciera lo mismo que la 
original, pero con una interfaz de usuario mas a mi gusto, el modelo de 
seguridad de Sugar no me lo permitiria. Una version mas moderada 
podria ser util igual. Asi como cuando Kal-EI, de vez en cuando elige ser 
Clark Kent en vez de Superman, mi Actividad Journal puede ser una 
alternativa valiosa a la Actividad Journal incorporada cuando no se 
necesiten super poderes. 
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Mi Actividad, a la que llamo Sugar Commander, tiene dos pestanas. 
Una representa al Journal y se ve asi: 



ThrCmlUEc.bJM^a 

IkiMdL.HKD- 



Title 



1tie_Creat jres_of_Man by Howard L. Myers 



Short stories t>f an undeirated science fiction auttor 

who died in the I970's. Free RTF from tiie Baen Free 

Description Ljbrary. 



Howard L. Myers, Science Fiction 



lags 



TitN 


i w MIME 


Tlie Angel of the Resolution, by George Griffith 




applicationftif 1 


iTtie.creatui-es.oLf^ari by Howard L, Myers W 




^^^^V apjplicacion/rtf ^^^^^^^^^^^| 


The Eriisrsid city of Oi. by L. Frar^k Bsum pio 




applicstion^ip 


Ttte Hound of the Baskefvilles. isy A. Conan Doyle 


P-t 


appiication/zip 


The island of Doctor Moreau. by H, c, weUs P?7 




applicacisn^ip 


Ths jiipiter weapon, by Charles Lauis Fontenay 




applicacionrpdf 


The Mummy and Miss Hitocris, by Ceorge Griffith 


P3 


application/'zip | 



The Niahc Life of the Qtii. l>v Thome smitti P7 



a»»lication/jip 



En esta pestana se puede navegar sobre el contenido del Diario, 
ordenarlo por Titulo o por Tipo MIME, seleccionar entradas, ver detalles, 
editar Titulo, Descripcion o Etiquetas, y borrar entradas no deseadas. La 
otra pestana muestra archivos y carpetas y se ve asi: 
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^Recently Used 

P=^ Desktop 
(3 File System 
198 GB filesystem 
0515 MB Filesystem 
(330 GB Hlesystem 
^^ Documents 
p^ Music 
p^ Pictures 
p"; Videos 



j(«: 



Creating Su^sr Activities .odt 
Q GetlABools-S.xo 
D] LeerPendnve-l.xo 
Q FteadETexts-19,xn 
^ SugarCommander-l.xo 
D] svnz-Ol.KO 
Q WewSiides-ll.KO 



12/20/2009 

03/15,12010 

03/16/2010 

03/08(2010 

ftsteidayat 55:5? 

15:47 

03/13/2010 



espy File "ID Tlie journal 



Esta pestana permite navegar por archives y directories del sistema de 
archives regular, incluyendo pendrives y tarjetas SD. Permite tambien, 
seleccionar un archive y convertirlo en una entrada del Diario apretando 
el boton al pie de la pantalla. 

Esta Actividad tiene muy poco codigo y sin embargo logra hacer todo lo 
que otra Actividad en relacion al Diario. Con este comando puedes 
descargaria desde el repositorio Git. 

git clone git : //git . sugarlabs . org/sugar-commander/\ 
mainline . git 

Hay un solo archivo fuente, sugarcommander.py: 

import logging 

import OS 

import gtk 

import pango 

import zipfile 

from sugar import mime 

from sugar . activity import activity 

from sugar . datastore import datastore 

from sugar . graphics . alert import NotifyAlert 

from sugar . graphics import style 

from gettext import gettext as _ 

import gobject 

import dbus 

COLUMN_TITLE = 

COLUMN_MIME = 1 

COLUMN_JOBJECT = 2 

DS_DBUS_SERVICE 



DS_DBUS_INTERFACE 
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'org. laptop. sugar. Datastore' 
= ' org . laptop . sugar . Datastore' 



DS_DBUS_PATH = ' /org/laptop/sugar/DataStore ' 
_logger = logging . getLogger( ' sugar-commander ' ) 
class SugarCommander (activity .Activity) : 

def init (self, handle, create_jobject=True) : 

"The entry point to the Activity" 

activity .Activity . init (self, handle. False) 

self . selected_journal_entry = None 

self . selected_path = None 

canvas = gtk. Notebook( ) 

canvas . props . show_border = True 

canvas . props . show_tabs = True 

canvas . show( ) 

self .ls_journal = gtk. ListStore( 

gobject .TYPE_STRING, 

gobject .TYPE_STRING, 

gobject .TYPE_PYOBJECT) 
self . tv_journal = gtk .TreeView(self . ls_journal) 
self. tv_journal. set_rules_hint(True) 
self. tv_journal. set_search_column(COLUMN_TITLE) 
self . selection_journal = \ 

self . tv_ journal . get_selection( ) 
self. selection_journal . set_mode( 

gtk.SELECTION_SINGLE) 
self. selection_journal .connect( "changed", 

self . selection_journal_cb) 
renderer = gtk .CellRendererText ( ) 
renderer. set_property( 'wrap-mode', gtk . WRAP_WORD) 
renderer. set_property( 'wrap -width ' , 500) 
renderer. set_property( 'width ' , 500) 
self .col_journal = gtk .TreeViewColumn(_( 'Title ' ), 

renderer, text=COLUMN_TITLE) 
self . col_ journal . set_sort_column_id(COLUMN_TITLE) 
self. tv_journal. ap pen d_column( self .col_j our nal) 
mime_renderer = gtk . CellRendererText ( ) 
mime_renderer.set_property( 'width ' , 500) 
self .col_mime = gtk .TreeViewColumn(_( ' MIME' ) , 

mime_renderer, text=COLUMN_MIME) 
self .col_mime . set_sort_column_id(COLUMN_MIME) 
self. tv_journal. append_column(self .col_mime) 
self .list_scroller_journal = gtk .ScrolledWindow( 

hadjustment=None, vadjustment=None) 
self .lis t_scroller_j our nal. set_policy( 

gtk.POLICY_AUTOMATIC, gt k . POLICY_AUTOMATIC) 
self .lis t_scroller_j our nal. add (self . tv_ jour nal) 
label_attributes = pango . AttrList( ) 
label_at tributes .insert (pango. At trSize( 

14000, 0, -1)) 
label_at tributes .insert (pango. At trForeground( 

65535, 65535, 65535, 0, -1)) 
tabl_label = gtk . Label(_( "Journal" ) ) 
tabl_label. set_attributes(label_at tributes) 
tabl_label . show( ) 
self. tv_journal. show( ) 
self .lis t_scroller_j our nal. show( ) 
column_table = gtk.Table(rows=l, columns=2, 

homogeneous = False) 
image_table = gtk .Table( rows=2, columns=2, 

homogeneous=False) 
self. image = gtk.Image() 
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image_table . attach(self. image, 0, 2, 0, 1, 

xoptions=gtk. FILL I gtk. SHRINK, 

yoptions=gtk. FILL I gtk. SHRINK, 

xpadding=10, 

ypadding=10) 
self .btn_save = gtk . Button(_( "Save" ) ) 
self . btn_save . connect ( ' button_press_event ' , 

self . save_button_press_event_cb) 
image_table . attach(self . btn_save, 0, 1, 1, 2, 

xop t ion s=gtk. SHRINK, 

yoptions=gtk. SHRINK, xpadding=10, 

ypadding=10) 
self . btn_save . props . sensitive = False 
self . btn_save . show( ) 

self .btn_delete = gtk . Button(_( "Delete" ) ) 
self . btn_delete . connect ( ' button_press_event ' , 

self . delete_button_press_event_cb) 
image_table . attach(self . btn_delete, 1, 2, 1, 2, 

xop t ion s=gtk. SHRINK, 

yoptions=gtk. SHRINK, xpadding=10, 

ypadding=10) 
self . btn_delete . props . sensitive = False 
self . btn_delete . show( ) 
column_table .attach(image_table, 0, 1, 0, 1, 

xoptions=gtk. FILL I gtk. SHRINK, 

yoptions=gtk. SHRINK, xpadding=10, 

ypadding=10) 
entry_table = gtk.Table( rows=3, columns=2, 

homogeneous=False) 
title_label = gtk. Label(_( "Title" ) ) 
entry_table . attach(title_label, 0, 1, 0, 1, 

xop t ion s=gtk. SHRINK, 

yop t ion s=gtk. SHRINK, 

xpadding=10, ypadding=10) 
title_label . show( ) 

self . title_entry = gtk . Entry(max=0) 
entry_table . attach(self . title_entry, 1, 2, 0, 1, 

xoptions=gtk. FILL I gtk. SHRINK, 

yoptions=gtk .SHRINK, xpadding=10, ypadding=10) 
self . title_entry . connect ( ' key_press_event ' , 

self . key_press_event_cb) 
self . title_entry . show( ) 

description_label = gtk. Label(_( "Description" ) ) 
entry_table . attach(description_label, 0, 1, 1, 2, 
xoptions=gtk. SHRINK, 
yoptions=gtk. SHRINK, 
xpadding=10, ypadding=10) 
description_label. show( ) 

self .description_textview = gtk.TextView( ) 
self .de scrip tion_t ex t view. set_wrap_mode( 

gtk.WRAP_WORD) 
entry_table .attach(self. description_textview, 

1, 2, 1, 2, 

xoptions=gtk. EXPAND I gtk. FILL I gtk. SHRINK, 

yoptions=gtk. EXPAND I gtk. FILL I gtk. SHRINK, 

xpadding=10, ypadding=10) 
self .description_textview. props .accepts_tab = False 
self . description_textview. connect ( ' key_press_event ' , 

self . key_press_event_cb) 
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self. description_textview. show( ) 
tags_label = gtk . Label(_( "Tags" ) ) 
entry_table . attach(tags_label, 0, 1, 2, 3, 

xoptions=gtk. SHRINK, 

yoptions=gtk. SHRINK, 

xpadding=10, ypadding=10) 
tags_label. show( ) 

self . tags_textview = gtk .TextView( ) 
self. tags_textview. set_wrap_mode(gtk .WRAP_WORD) 
entry_table . attach(self . tags_textview, 1, 2, 2, 3, 

xoptions=gtk.FILL, 

yoptions=gtk. EXPAND I gtk. FILL, 

xpadding=10, ypadding=10) 
self . tags_textview. props . accepts_tab = False 
self. tags_textview. connect ( ' key_press_event ' , 

self . key_press_event_cb) 
self. tags_textview. show( ) 
entry_table . show( ) 
self . scroller_entry = gtk .ScrolledWindow( 

hadjustment=None, vadjustment=None) 
self .scrolle r_en try . set_policy(gtk. POLICY_NEVER, 

gtk.POLICY_AUTOMATIC) 
self. scroller_entry . add_with_viewport(entry_table) 
self. scroller_entry . show( ) 
column_table .attach(self. scroller_entry, 

1, 2, 0, 1, 

xoptions=gtk. FILL I gtk. EXPAND I gtk. SHRINK, 

yoptions=gtk. FILL I gtk. EXPAND I gtk. SHRINK, 

xpadding=10, ypadcling=10) 
image_table . show( ) 
column_table . show( ) 

vbox = gtk .VBox(homogeneous=True, spacing=5) 
vbox. pack_start(column_table) 
vbox. pack_end(self .list_scroller_journal) 
canvas . append_page(vbox, tabl_label) 
self ._filechooser = gtk. FileChooserWidget( 

action=gtk . FILE_CHOOSER_ACTION_OPEN, 

backend=None) 
self._filechooser. set_current_folder( "/media" ) 
self .copy_button = gtk.Button( 

_("Copy File To The Journal")) 
self .copy_but ton .connect( 'clicked', 

self . create_journal_entry) 
self .copy_but ton . show( ) 

self._filechooser. set_extra_widget (self . copy_button) 
preview = gtk.Image() 

self._filechooser. set_preview_widget (preview) 
self. _filechooser. connect ("update-preview", 

self . update_preview_cb, preview) 
tab2_label = gtk . Label(_( "Files" ) ) 
tab2_label. set_attributes(label_at tributes) 
tab2_label. show( ) 

canvas . append_page(self ._filechooser, tab2_label) 
self. set_canvas( canvas) 
self. show_all( ) 

toolbox = activity .ActivityToolbox(self) 
activity_toolbar = toolbox. get_activity_toolbar ( ) 
activity_toolbar . keep . props .visible = False 
activity_toolbar . share . props .visible = False 
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self . set_toolbox( toolbox) 
toolbox. show( ) 
self . load_journal_table( ) 
bus = dbus .SessionBus( ) 
remote_object = bus . get_object ( 

DS_DBUS_SERVICE, DS_DBUS_PATH ) 
_datastore = dbus . Interface( remote_object, 

DS_DBUS_INTERFACE) 
_datastore. connect_to_signal( 'Created ' , 

self . datastore_created_cb) 
_datastore. connect_to_signal( 'Updated ' , 

self . datastore_updated_cb) 
_datastore. connect_to_signal( 'Deleted ' , 

self . datastore_deleted_cb) 
self . selected_journal_entry = None 
def update_preview_cb(self , file_chooser, preview): 
filename = file_chooser . get_preview_f ilename( ) 
try: 

file_mimetype = mime . get_for_file(filename) 
if file_mimetype. startswith( ' image/' ) : 
pixbuf = \ 

gtk . gdk . pixbuf_new_f rom_f ile_at_size( 
filename, 

style. zoom (320), style . zoom (240) ) 
preview. set_from_pixbuf( pixbuf) 
have_preview = True 
elif file_mimetype == ' application/x-cbz ' : 
fname = self .extract_image(filename) 
pixbuf = \ 

gtk .gdk . pixbuf_new_f rom_f ile_at_size( 
fname, 

style. zoom (320), style . zoom (240) ) 
preview. set_from_pixbuf( pixbuf) 
have_preview = True 
OS . remove(f name) 
else : 

have_preview = False 
except : 

have_preview = False 
f ile_chooser . set_preview_widget_active( 

have_preview) 
return 
def key_press_event_cb(self , entry, event): 

self . btn_save . props . sensitive = True 
def save_button_press_event_cb(self , entry, event): 

self . update_entry( ) 
def delete_button_press_event_cb(self , entry, event): 
datastore.delete( 

self . selected_journal_entry . object_id) 
def datastore_created_cb(self , uid): 
new_jobject = datastore. get(uicl) 
iter = self . ls_journal . append( ) 
title = new_jobject .metadata[ ' title ' ] 
self .ls_journal.set(iter, COLUMN_TITLE, title) 
mime = new_jobject . metadata[ 'mime_type ' ] 
self .ls_journal. set(iter, COLUMN_MIME, mime) 
self .ls_] our nal.se t( iter, COLUMN_JOBJECT, 
new_j object) 
def datastore_updated_cb(self , uid): 
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new_jobject = datastore . get(uid) 

iter = self . ls_journal . get_iter_first( ) 

for row in self . ls_journal: 

jobject = row[COLUMN_JOBJECT] 

if jobject . object_id == uid: 

title = new_jobject .metadata[ ' title ' ] 
self .ls_j our nal. set_value(iter, 

COLUMN_TITLE, title) 
break 

iter = self . ls_journal. iter_next (iter) 
object_id = self . selected_journal_entry . object_id 
if object_id == uid: 

self . set_form_f ields( new_j object ) 
def datastore_deleted_cb(self , uid): 
save_path = self . selected_path 
iter = self . ls_journal . get_iter_first( ) 
for row in self . ls_journal: 

jobject = row[COLUMN_JOBJECT] 

if jobject . object_id == uid: 

self .ls_j our nal. remove (iter) 
break 

iter = self . ls_journal. iter_next (iter) 
try: 

self . selection_journal. select_path(save_path) 

self . tv_journal . grab_focus( ) 
except : 

self . title_entry . set_text( ' ' ) 

description_textbuffer = \ 

self .desc rip tion_t ex t view. get_buffer( ) 

description_textbuffer . set_text( ' ' ) 

tags_textbuffer = \ 

self. tags_textview. get_buffer( ) 

tags_text buffer . set_text ( ' ' ) 

self . btn_save . props . sensitive = False 

self . btn_delete . props . sensitive = False 

self . image . clear( ) 

self . image . show( ) 
def update_entry(self ) : 
needs_update = False 
if self . selected_journal_entry is None: 

return 
object_id = self . selected_journal_entry . object_id 
jobject = datastore . get (object_id) 
old_title = jobject .metadata. get( ' title ' , None) 
if old_title != self . title_entry. props . text : 

jobject .metadata[ ' title ' ] = \ 
self. title_entry . props. text 

jobject .metadata[ ' title_set_by_user ' ] = '1' 

needs_update = True 
old_tags = jobject .metadata. get (' tags ' , None) 
new_tags = \ 

self . tags_textview. props. buffer. props. text 
if old_tags != new_tags: 

jobject .metadata[ ' tags ' ] = new_tags 

needs_update = True 
old_description = jobject .metadata. get( 

'description', None) 
new_description = \ 

self . d esc ription_text view. props. buffer. props. text 
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if old_description != new_description : 

jobject .metadata[ ' description ' ] = new_description 
needs_update = True 
if needs_update : 

datastore.write(jobject, update_mtime=False, 
reply_handler=self . datastore_write_cb, 
error_handler=self .datastore_write_error_cb) 
self . btn_save . props . sensitive = False 
def datastore_write_cb(self ) : 

pass 
def datastore_write_error_cb(self , error): 
logging . error( 

' sugar commander . datastore_write_error_cb: ' 
' %r ' % error) 
def close(self, skip_save=False) : 

"Override the close method so we don't try to 
create a Journal entry." 
activity .Activity . close(self, True) 
def selection_journal_cb(self , selection): 
self . btn_delete . props . sensitive = True 
tv = selection . get_tree_view( ) 
model = tv. get_model( ) 
sel = selection . get_selected( ) 
if sel: 

model, iter = sel 

jobject = model. get_value(iter, COLUMN_JOBJECT) 
jobject = datastore. get( jobject . object_id) 
self . selected_journal_entry = jobject 
self . set_form_fields( jobject) 
self . selected_path = model . get_path(iter) 
def set_form_f ields(self , jobject): 

self . title_entry . set_text( jobject . metadata [' title '] ) 
description_textbuffer = \ 

self . description_textview. get_buffer() 
if jobject. metadata. has_key( 'description' ) : 
description_text buffer . set_text( 

jobject. met adata[ 'description']) 
else : 

description_textbuffer . set_text( ' ' ) 
tags_textbuffer = self . tags_textview. get_buff er( ) 
if jobject. metadata. has_key( ' tags ' ) : 

tags_textbuffer . set_text( jobject . metadata [' tags '] ) 
else : 

tags_textbuffer . set_text ( ' ' ) 
self .create_pre view (jobject . object_id) 
def create_preview(self , object_id): 
jobject = datastore . get(object_id) 
if jobject. metadata. has_key( 'preview' ) : 
preview = jobject . metadata[ ' preview' ] 
if preview is None or preview == ' ' \ 
or preview == 'None': 

if jobject. met ad ata[ 'mime_type ' ] . startswith( 
' image/ ' ) : 

filename = jobject . get_file_path( ) 
self . show_image(f ilename) 
return 
if jobject .metadata[ 'mime_type ' ] == \ 
' application/x-cbz ' : 
filename = jobject . get_file_path( ) 
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fname = self . extract_image(f ilename) 
self . show_image(f name) 
OS . remove (fname) 
return 
if jobject . metadata. has_key( ' preview' ) and \ 
len(jobject .metadata[ ' preview' ] ) > 4: 
if jobject .metadata[ ' preview' ] [1 :4] == 'PNG': 

preview_data = jobject .metadata[ ' preview' ] 
else : 

import base64 
preview_data = \ 

base64.b64decode( 
jobject. metadatai' preview' ] ) 
loader = gtk . gdk. Pixbuf Loader( ) 
loader .write(preview_data) 
scaled_buf = loader . get_pixbuf( ) 
loader . close( ) 

self . image . set_f rom_pixbuf (scaled_buf ) 
self . image . show( ) 
else: 

self . image . clear( ) 
self . image . show( ) 
def load_journal_table(self ) : 

self . btn_save . props . sensitive = False 
self . btn_delete. props . sensitive = False 
ds_mounts = datastore . mounts( ) 
mountpoint_id = None 
if len(ds_mounts) == 1 and \ 
ds_mounts[0] [ 'id ' ] == 1: 
pass 
else: 

for mountpoint in ds_mounts: 
id = mountpoint [' id ' ] 
uri = mountpoint [' uri' ] 
if uri . startswith( ' /home ') : 
mountpoint_id = id 
query = {} 
if mountpoint_id is not None: 

query[ ' mountpoints ' ] = [ mountpoint_id ] 
ds_objects, num_objects = \ 

datastore. find(query, properties=['uid', 
'title', 'mime_type ' ] ) 
self .ls_j our nal. clear ( ) 
for i in xrange (0, num_objects, 1): 
iter = self . ls_journal. append( ) 
title = ds_objects[i] .metadata[ ' title ' ] 
self .ls_journal.set(iter, COLUMN_TITLE, title) 
mime = ds_objects[i] . metadata[ 'mime_type ' ] 
self . ls_journal. set (iter, COLUMN_MIME, mime) 
self .ls_journal. set (iter, COLUMN_JOBJECT, 

ds_objects[i] ) 
if not self . selected_journal_entry is None and 
self . selected_journal_entry . object_id == \ 
ds_objects[i] .object_id: 
self. selection_journal . select_iter (iter) 
self .ls_j our nal. set_sort_column_id(COLUMN_TITLE, 

gtk.SORT_ASCENDING) 
v_adjustment = \ 

self . list_scroller_journal . get_vadjustment( ) 
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v_adjustment .value = 
return ds_objects[0] 
def create_journal_entry(self , widget, data=None): 
filename = self ._f ilechooser . get_filename( ) 
journal_entry = datastore. create( ) 
journal_entry .metadata[ ' title ' ] = \ 

self . ma ke_new_file name (file name) 
journal_entry .metadata[ ' title_set_by_user ' ] = '1' 
journal_entry .metadata[ ' keep ' ] = '0' 
file_mimetype = mime . get_f or_file(f ilename) 
if not file_mimetype is None: 

journal_entry .metadata[ 'mime_type ' ] = \ 
file_mimetype 
journal_entry .metadata[ ' buddies ' ] = '' 
if f ile_mimetype . startswith( 'image/ ' ) : 

preview = \ 

self .create_pre view_me tad at a( file name) 
elif file_mimetype == ' application/x-cbz ' : 

fname = self . extract_image(filename) 

preview = self .create_preview_metadata(f name) 

OS . remove(f name) 
else : 

preview = ' ' 
if not preview == ' ' : 

journal_entry .metadata[ ' preview' ] = \ 

dbus . ByteAr ray (preview) 
else : 

journal_entry .metadata[ ' preview' ] = '' 
]ournal_entry . file_path = filename 
datastore. write ( jour nal_en try) 

self . alert(_( 'Success ' ), _( '%s added to Journal.') 
% self . make_new_f ilename(filename) ) 
def alert(self, title, text=None): 
alert = NotifyAlert( timeout=20) 
alert . props . title = title 
alert . props .msg = text 
self .add_alert (alert ) 

alert .connect('response', self. alert_cancel_cb) 
alert . show( ) 
def alert_cancel_cb(self , alert, response_id) : 

self . remove_alert (alert ) 
def show_image(self , filename): 

"display a resized image in a preview" 

scaled_buf = gtk . gdk. pixbuf_new_f rom_file_at_size( 

filename, 

style. zoom (320), style . zoom (240) ) 
self . image . set_f rom_pixbuf (scaled_buf ) 
self . image . show( ) 
def extract_image(self , filename): 

zf = zipfile .ZipFile(filename, 'r') 
image_files = zf . namelist ( ) 
image_files . sort( ) 
file_to_extract = image_files[0] 
extract_new_f ilename = self .make_new_filename( 

file_to_ex tract) 
if extract_new_filename is None or \ 

extract_new_filename == ' ' : 

# skip over directory name if the images 

# are in a subdirectory. 
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f ile_to_extract = image_f iles[l] 

extract_new_filename = self .make_new_filename( 
f ile_to_extract ) 
if len(image_files) > 0: 

if self . save_extracted_file(zf , file_to_extract ) : 
fname = os . path . join(self . get_activity_root( ), 
' instance ' , 

extract_new_filename) 
return fname 
def save_extracted_f ile(self , zipfile, filename): 

"Extract the file to a temp directory for viewing" 
try: 

filebytes = zipfile. read(filename) 
except zipfile . BadZipfile, err: 

print 'Error opening the zip file: %s ' % (err) 

return False 
except KeyError, err: 

self . alert (' Key Error', 'Zipfile key not found: ' 
+ str(filename) ) 

return 
outfn = self .make_new_filename(f ilename) 
if (outfn == ' ' ) : 

return False 
fname = os . path . join(self . get_activity_root( ), 

' instance ' , outfn) 
f = open(f name, 'w' ) 
try: 

f.write(file bytes) 
finally: 

f . close( ) 
return True 
def make_new_f ilename(self , filename): 

partition_tuple = filename. rpartition( '/' ) 
return partition_tuple[2] 
def create_preview_metadata(self , filename): 
file_mimetype = mime. get_for_file(f ilename) 
if not file_mimetype. startswith( ' image/ ') : 

return ' ' 
scaled_pixbuf = \ 

gtk . gdk . pixbuf_new_f rom_f ile_at_size( 

filename, 

style. zoom (320), style. zoom (240) ) 
preview_data = [] 
def save_f unc(buf , data): 

data. append(buf ) 
scaled_pixbuf . save_to_callback(save_func, 

'png', 

user_data=preview_data) 
preview_data = ' ' . join(preview_data) 
return preview_data 

Miremos este codigo analizando los metodos de a uno. 

Agregar una entrada al Journal 

Cuando alguien pulsa un boton del gtk.FileChooser se agrega una 
entrada al Journal. Este es el codigo que se ejecuta. 
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def create_journal_entry(self , widget, data=None) : 
filename = self ._f ilechooser . get_filename( ) 
journal_entry = datastore. create( ) 
journal_entry .metadata[ ' title ' ] = \ 

self . make_new_f ilename( 

filename) 
journal_entry .metadata[ ' title_set_by_user ' ] = '1' 
journal_entry .metadata[ ' keep ' ] = '0' 
file_mimetype = mime. get_f or_file(f ilename) 
if not file_mimetype is None: 

journal_entry .metadata[ 'mime_type ' ] = \ 
file_mimetype 
journal_entry .metadata[ ' buddies ' ] = '' 
if f ile_mimetype . startswith( 'image/ ' ) : 

preview = self .create_preview_metadata(filename) 
elif file_mimetype == ' application/x-cbz ' : 

fname = self . extract_image(filename) 

preview = self .create_preview_metadata(f name) 

OS . remove(f name) 
else : 

preview = ' ' 
if not preview == ' ' : 

journal_entry .metadata[ ' preview' ] = \ 
dbus . By teAr ray (preview) 
else : 

journal_entry .metadata[ ' preview' ] = '' 
]ournal_entry . file_path = filename 
datastore. write ( jour nal_en try) 

La metadata es lo unico que vale la pena comentar de esto, title (titulo) 
es lo que se indica como #3 en la imagen debajo. title_set_by_user 
(titulo elegido por el autor) se setea en 1 para que la Actividad no pida al 
usuario cambiar el titulo cuando se cierre. keep refiere a las estrellitas 
que aparecen al inicio de la entrad del Journal (ver #1 en la imagen 
debajo), se encienden con keep seteado en 1 y se apagan en 0. buddies 
es la lista de usuarios que colaboraron en esta entrada del Journal, no 
hay ninguno en este ejempio pero aparecen en #4 en la imagen debajo. 
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preview es una imagen en formato PNG que muestra la captura de 
pantalla de la Actividad en uso. Esta es creada por la propia Actividad 
cuando se ejecuta de modo que no es necesario crearia al agregar una 
entrada al Diario. Simplemente se deja el string vacio (") para esta 
propiedad. 

Como en el Sugar Commander, las preview son mucho mas visibles que 
en la Actividad Journal normal, decidi que Sugar Commander creara una 
imagen de preview para todo archivo de imagen o libros que se agregara 
al Journal. Para esto hice un pixbuf de la imagen para que se ajuste a la 
dimensiones escaladas de 320x240 pixeles y luego un dbus.ByteArray 
desde ahi, porque este es el formato que el Journal usa para guardar las 
imagenes de preview. 

El mime_type describe el formato del archivo y generalmente se asigna 
sobre la base del sufijo del nombre de archivo. Por ejempio, archivos 
terminados en .html tienen tipo MIME 'text/html'. Python tiene un 
paquete llamado mimetypes que a partir del nombre del archivo 
deduce de que tipo MIME se trata, pero Sugar tiene su propio paquete 
para hacer la misma cosa. Para la mayoria de los archivos es indistinto 
usar uno u otro pero como Sugar tiene sus propios MIME para cosas 
como los "bundles" (empaquetados) de las Actividades, es mejor utilizar 
el paquete de tipos MIME de Sugar. Puedes importarlo de esta forma: 

from sugar import mime 

El resto de la metadata ( icono, hora de modificacion) se crea 
automaticamente. 
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No agregar una entrada al Journal 

Las Actividades Sugar crean por defecto la entrada al Diario usando el 
metodo write_file(). Pero hay algunas Actividades que no se 
beneficiarian al hacer esto. Por ejempio, 'Get Internet Archive Books' 
(Descargar libros de Internet) descarga los e-books al Diario, pero no 
tiene una entrada de Diario propia. Lo mismo ocurre con el propio Sugar 
Commander. 

Si creas un juego que registre los mejores puntajes y los guarde. Puedes 
guardar esos puntajes en una entrada del Journal pero eso requiere que 
los jugadores retomen el juego desde el Journal y no desde el anillo 
inicial de Actividades. Por eso tu puedes preferir guardar estos registros 
en un archivo en el directorio de datos y no dejar una entrada en el 
Journal. 

Sugar te da un procedimiento para esto. Primero hay que especificar un 
argumento extra en metodo init () de tu Actividad de esta forma: 

class SugarCommander(activity. Activity) : 

def init (self, handle, create_jobject=True) : 

"The entry point to the Activity" 

activity .Activity . init (self, handle. False) 

En segundo lugar hay que editar el metodo closeO de esta manera: 

def close(self, skip_save=False) : 

"Override the close method so we don't try to 

create a Journal entry." 

activity .Activity . close(self. True) 

Esto es todo lo necesario para evitar la entrada en el Journal. 
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Listar las entradas del Journal 



Si se quiere una lista de las entradas del Journal, se puede usar el 
metodo findO de datastore. El metodo find usa un argumento que 
contiene el criterio de busqueda. Si quisieras buscar archives de imagen 
podrias filtrar por mime-type usando sentencias como esta: 

ds_objects, num_objects = datastore . find( 
{ ' mime_type ' : [ ' image/ j peg ' , 
'image/gif, 'image/tiff, ' image/png ' ]}, 
properties=[ ' uid ' , 
'title', ' mime_type ' ] ) ) 

Podemos usar cualquier atributo de metadata como criterio de 
busqueda. Para listar todo en el Diario usamos un criterio vacio como 
este: 

ds_objects, num_objects = datastore . find({}, 
properties=[ ' uid ' , 
'title', ' mime_type ' ] ) ) 

El argumento "properties" selecciona que metadata se pide para cada 
objeto de la lista. Aunque conviene limitar esta seleccion siempre se 
debe incluir el uid. A la vez nunca se debe incluir en un listado el 
preview. Este es un archivo de imagen con la vista de la Actividad tal y 
como se veia al usarse por ultima vez. Hay formas simples de pedir esta 
imagen para una entrada puntual del Diario pero nunca es conveniente 
incluir este pedido en una lista porque enlenteceria enormemente el 
funcionamiento. 

Obtener un listado completo del Journal es complicado dada la 
reescritura que se hizo del datastore para Sugar .84. Antes de esto el 
metodo datastore. findO listaba simultaneamente las entradas al 
Diario y los archivos sobre medios externos, como tarjetas SD y 
pendrives. En .84 o posteriores solo lista entradas de Diario. 
Afortunadamente es posible escribir codigo que soporte el 
comportamiento anterior. Aca el codigo que en Sugar Commander lista 
exclusivamente las entradas al Diario. 

def load_journal_table(self ) : 

self . btn_save . props . sensitive = False 

self . btn_delete. props . sensitive = False 

ds_mounts = datastore .mounts( ) 

mountpoint_id = None 

if len(ds_mounts) == 1 and ds_mounts[0] [ ' id ' ] == 1: 

pass 
else: 

for mountpoint in ds_mounts: 
id = mountpoint [' id ' ] 
uri = mountpoint [' uri' ] 
if uri . startswith( ' /home ') : 
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mountpoint_id = id 
query = {} 
if mountpoint_id is not None: 

query[ 'mountpoints ' ] = [ mountpoint_id ] 
ds_objects, num_objects = datastore . f ind( 
query, properties=[ ' uid ' , 
'title', 'mime_type ' ] ) 
self .ls_journal. clear ( ) 
for i in xrange (0, num_objects, 1): 
iter = self .ls_journal. append( ) 
title = ds_objects[i] .metadata[ ' title ' ] 
self . ls_journal . set (iter, 

COLUMN_TITLE, title) 
mime = ds_objects[i] .metadata[ ' mime_type ' ] 
self . ls_journal . set(iter, COLUMN_MIME, mime) 
self .ls_j our nal. set (iter, COLUMN_JOBJECT, 

ds_objects[i] ) 
if not self . selected_journal_entry is None and \ 
self . selected_journal_entry . object_id == \ 

ds_objects[i] . object_id : 
self. selection_journal . select_iter(iter) 
self .ls_journal. set_sort_column_id(COLUMN_TITLE, 

gtk.SORT_ASCENDING) 
v_adjustment = \ 

self . list_scroller_journal . ge t_vad just men t( ) 
v_adjustment . value = 
return ds_objects[0] 

Necesitamos usar el metodo datastore.mountsO con doble proposito: 



En Sugar .82 y anteriores el listado incluye todos los mount points 
(puntos de montaje) incluido el lugar donde se monta el Diario y los 
puntos para medios externos. A la vez "mountpoint" es un 
diccionario Python que tiene una propiedad uri (que es la ruta al 
punto de montaje) y una propiedad id (que es el nombre dado al 
punto de montaje). Cada entrada de Diario tiene el atributo 
mountpoint en su metadata. El uri del Journal sera el unico que 
empieza con /liome, entonces para listar unicamente objetos del 
Diario limitamos la busqueda a objetos donde la id del punto de 
montaje sea igual a la metadata mountpoint. 

En Sugar .84 y posteriores el metodo datastore.mountsO existe 
pero no da informacion acerca de puntos de montaje. Sin embargo 
se puede usar el codigo pegado encima para comprobar que hay un 
unico punto de montaje y que su id es 1. Si esto es asi, es porque 
estamos trabajando con el datastore reescrito de .84 o posterior. 
Otra diferencia es que los objetos del Journal ya no tendran en la 
metadata a mountpoint como clave. Si vemos el codigo previo, 
atiende esta diferencia y funciona con cualquiera de las versiones de 
Sugar. 
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<LQue hacer si queremos el comportamiento de Sugar .82, o sea listar 
como objetos del Diario tanto las entradas al mismo como los archives 
de un USB? Quise eso para View Slides y termine usando este codigo: 

def load_journal_table(self ) : 

ds_objects, num_objects = datastore . find( 
{ ' mime_type ' : [ ' image/ j peg ' , 
' image/gif ' , 'image/tiff, ' image/png ' ]}, 
properties=[ ' uid ' , 'title', ' mime_type ' ] ) 
self.ls_right.clear() 
for i in xrange (0, num_objects, 1): 
iter = self .ls_right . append( ) 
title = ds_objects[i] .metadata[ ' title ' ] 
mime_type = ds_objects[i] .metadata[ 'mime_type ' ] 
if mime_type == ' image/ j peg ' \ 

and not title .endswith( ' .jpg ' ) \ 

and not title .endswith( '. jpeg ' ) \ 

and not title .endswith( '. JPG ' ) \ 

and not title .endswith( '. JPEG' ) : 

title = title + ' . jpg ' 
if mime_type == 'image/png' \ 

and not title .endswith( '. png ' ) \ 

and not title . endswith( '. PNG ') : 

title = title + ' . png ' 
if mime_type == 'image/gif \ 

and not title . endswith( '. gif ' )\ 

and not title . endswith( '. GIF ') : 

title = title + ' .gif 
if mime_type == 'image/tiff \ 

and not title .endswith( '. tiff )\ 

and not title .endswith( ' .TIFF ') : 

title = title + ' .tiff 
self .ls_right .set(iter, COLUMN_IMAGE, title) 
jobject_wrapper = JobjectWrapper( ) 
jobject_wrapper . set_jobject (ds_objects[i] ) 
self .ls_right .set (iter, COLUMN_PATH, 

jobject_wrapper ) 
valid_endings = ('.jpg', '.jpeg', '.JPEG', 
'.JPG', '.gif, '.GIF', '.tiff, 
' .TIFF' , ' .png' , ' .PNG' ) 
ds_mounts = datastore . mounts( ) 
if len(ds_mounts) == 1 and ds_mounts[0] [ ' id ' ] == 1: 

# datastore. mounts( ) is stubbed out, 

# we're running .84 or better 

for dirname, dirnames, filenames in os.walk( 
' /media' ) : 
if ' .olpc . store ' in dirnames: 

dirnames . remove ( ' .olpc.store' ) 
# don't visit .olpc.store directories 
for filename in filenames: 

if filename .endswith(valid_endings) : 
iter = self . ls_right . append( ) 
jobject_wrapper = JobjectWrapper( ) 
jobject_wrapper . set_file_path( 

OS . path . join(dirname, filename)) 
self .ls_right. set (iter, COLUMN_IMAGE, 

filename) 
self .ls_right. set (iter, COLUMN_PATH, 
jobject_wrapper) 



209 



self .ls_right . set_sort_column_id(COLUMN_IMAGE, 
gtk.SORT_ASCENDING) 

En este caso utilice el metodo datastore.mountsO para descubrir que 
version del datastore estaba en uso y entonces si se trataba de .84 o 
posterior use os.waIkO para crear una lista plana de todos los archivos 
encontrados bajo el directorio /media (que es donde se montan los USB 
y las SD). No puedo transformar estos archivos en directorios, pero si 
hacer una clase wrapper que abarque tanto objetos del Diario como 
archivos, y usar estos objetos como normalmente utilizaria objetos del 
Diario. Esta clase wrapper se veria asi: 

class JobjectWrapper( ) : 

def init (self): 

self. jobject = None 

self. file_path = None 

def set_jobject (self , jobject): 

self. jobject = jobject 

def set_file_path(self , file_path): 

self. file_path = file_path 

def get_file_path(self ) : 

if self. jobject != None: 

return self . jobject . get_file_path( ) 

else : 

return self. file_path 

Usar las entradas del Journal 

Cuando se quiere leer una archivo guardado como objeto de Journal, se 
puede usar el metodo get_file_path() de un objeto Journal para obtener 
la ruta del archivo y abrirlo para lectura: 

fname = jobject . get_file_path( ) 

Una palabra de advertencia: esta ruta no existe hasta que no se llama al 
metodo get_file_path() y no existira despues. Con el Diario se trabaja 
sobre copias de los archivos del Diario y no sobre el original. Esta es la 
razon por la que no vale guardar para uso posterior la ruta obtenida 
mediante get_file_path() y en cambio si hay que guardar el objeto 
Journal y llamar al metodo cuando se necesite la ruta. 

Las entradas de metadata del Diario son en general cadenas y trabajan 
de formas esperables con la excepcion de preview: 

def create_preview(self , object_id): 
jobject = datastore . get(object_id) 
if jobject. metadata. has_key( 'preview' ) : 
preview = jobject . metadata[ ' preview' ] 
if preview is None or preview == ' ' or 
preview == ' None ' : 

if jobject. met ad ata[ 'mime_type ' ] . startswith( 
' image/ ' ) : 

filename = jobject . get_file_path( ) 
self . show_image(f ilename) 
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return 
if jobject .metadata[ 'mime_type ' ] == \ 
'application/x-cbz ' : 
filename = jobject . get_file_path( ) 
fname = self . extract_image(f ilename) 
self . show_image(f name) 
OS . remove(f name) 
return 
if jobject .metadata. has_key( ' preview' ) and \ 
len( jobject .metadata[ ' preview' ] ) > 4: 
if jobject .metadata[ ' preview' ] [1 :4] == 'PNG': 

preview_data = jobject .metadata[ ' preview' ] 
else : 

import base64 

preview_data = base64. b64decode( 
jobject. metadata[' preview' ] ) 
loader = gtk . gdk. Pixbuf Loader( ) 
loader .write(preview_data) 
scaled_buf = loader . get_pixbuf( ) 
loader .close( ) 

self . image . set_f rom_pixbuf (scaled_buf ) 
self . image . show( ) 
else: 

self . image . clear( ) 
self . image . show( ) 

El atributo preview difiere de otros de la metadata en dos maneras: 

• Nunca se debe incluir a preview como metadata cuando se pida una 
lista de los objetos del Journal. Necesitariamos una copia completa 
del objeto del Diario para obtener esto. Como ya tenemos un objeto 
del Diario podemos obtener el objeto completo solo conociendo su 
object id y entonces pidiendo una copia al datastore con ese id. 

• La imagen de preview es un binario (dbus.ByteArray) pero en las 
versiones de Sugar anteriores a .82 sera guardado como una cadena 
de texto. Para lograr esto se codifica base 64. 

El codigo a usar para obtener una copia entera de un objeto del Diario 
se ve asi: 

object_id = jobject . object_id 
jobject = datastore . get (object_id) 
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Para explicar que es codificar en base 64, digamos que seguramente 
escuchaste que las computadoras utilizan el sistema de numeracion en 
base dos, donde los unicos digitos son 1 y 0. Una unidad de 
almacenamiento de datos que puede contener solo un cero o un uno se 
llama bit. Las computadoras precisan almacenar otra informacion 
distinta de numeros y para esto se agrupan (generalmente) los bits de a 
8 y se llama byte a esta agrupacion. Si usamos 7 de los 8 bits en un byte 
podemos guardar un caracter del alfabeto romano, un signo de 
puntuacion, un digito o cosas como los caracteres que marcan 
tabulacion o avances de linea. Todo archivo que pueda crearse usando 
solamente 7 de los 8 bits sera un archivo de texto. Todo lo que necesite 
usar los 8 bits de cada byte, incluyendo programas, videos, musica o 
fotos de Jessica Alba se llamara binario. En versiones anteriores a Sugar 
.82 la metadata de un objeto del Journal solo podia almacenar cadenas 
de texto y de alguna forma habia que representar 8 bits usando 7 bits. 
Esto se resolvio agrupando los bytes en paquetes mas grandes y luego 
partiendolos de nuevo en grupos de 7 bits. Python tiene el modulo 
base64 para hacer esto. 

La codificacion base 64 es actualmente una tecnica muy comun. Si 
alguna vez enviaste un adjunto en un email, este viajo codificado en 
base 64. 

El codigo mostrado debajo muestra un par de formas de crear la imagen 
de preview. Si la metadata de preview contiene una imagen PNG esta se 
cargara sobre un pixbuf y se desplegara. Si el tipo MIME es el de un 
archivo de imagen o de un zip de imagenes, como los que usan los 
comics, crearemos el preview desde la misma entrada de Journal. 

El codigo verifica el primero de los tres caracteres en la metadata 
preview para ver si son 'PNG'. Si es asi, el archivo es un Portable 
Networic Grapliics que se guarda como binario y no necesita conversion 
a base 64 pero en otro caso la conversion es necesaria. 

Actualizar un objeto del Journal 

El codigo a utilizar para actualizar un objeto del Journal se ve asi: 

def update_entry(self ) : 
needs_update = False 
if self . selected_journal_entry is None: 

return 
object_id = self . selected_journal_entry .object_id 
jobject = datastore . get(object_id) 
old_title = jobject .metadata. get( ' title ' , None) 
if old_title != self . title_entry. props . text : 

jobject .metadata[ ' title ' ] = \ 
self. title_entry . props. text 

jobject .metadata[ ' title_set_by_user ' ] = '1' 

needs_update = True 
old_tags = jobject .metadata. get (' tags ' , None) 
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new_tags = \ 

self . tags_textview. props. buffer. props. text 
if old_tags != new_tags: 

jobject .metadata[ ' tags ' ] = new_tags 
needs_update = True 
old_description = \ 

jobject. me tadata.get( 'description' , None) 
new_description = \ 

self . d esc ription_text view. props. buffer. props. text 
if old_description != new_description : 
jobject .metadata[ ' description ' ] = \ 

new_description 
needs_update = True 
if needs_update: 

datastore.write(jobject, update_mtime=False, 
reply_handler=self . datastore_write_cb, 
error_handler=self . datastore_write_error_cb) 
self . btn_save . props . sensitive = False 
def datastore_write_cb(self ) : 

pass 
def datastore_write_error_cb(self , error): 
logging . error( 

' sugar commander . datastore_write_error_cb : ' 
' %r ' % error) 

Borrar una entrada del Diario 

El codigo para borrar una entrada del Diario es este: 

def delete_button_press_event_cb(self , entry, event): 
datastore.delete( 

self . selected_journal_entry . object_id) 

Obtener retro-llamadas (callbacks) desde el Journal 
usando D-Bus 

En el capitulo Hacer Actividades compartidas vimos como llamadas 
de D-Bus enviadas sobre Telepathy podian usarse para mandar 
mensajes desde una Actividad que se ejecuta en una computadora a la 
misma Actividad en una computadora distinta. Normalmente no se usa 
D-bus de esta forma sino para enviar mensajes entre programas que se 
ejecutan en la misma maquina. 

Por ejempio, al trabajar con el Diario se obtienen retro-llamadas cada 
vez que el Diario se actualiza. Tambien se generan retro-llamadas 
cuando la propia actividad es la que se refresca. Si es importante para tu 
Actividad saber si el Diario se actualizo o no, debieras obtener estas 
retro-llamadas. 

Lo primero que debes hacer es definir algunas constantes e importar el 
paquete D_Bus: 

DS_DBUS_SERVICE = ' org . laptop . sugar . DataStore ' 
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DS_DBUS_INTERFACE = ' org . laptop . sugar . DataStore ' 
DS_DBUS_PATH = ' /org/laptop/sugar/DataStore ' 
import dbus 

Luego, en tu metodo init () pon codigo para conectar las senales y 

hacer las retro-llamadas: 

bus = dbus .SessionBus( ) 
remote_object = bus . get_object ( 

DS_DBUS_SERVICE, DS_DBUS_PATH ) 
_datastore = dbus . Interface( remote_object, 

DS_DBUS_INTERFACE) 
_datastore. connect_to_signal( 'Created ' , 

self ._datastore_created_cb) 
_datastore. connect_to_signal( 'Updated ' , 

self ._datastore_updated_cb) 
_datastore. connect_to_signal( 'Deleted ' , 

self ._datastore_deleted_cb) 

Los metodos llamados por las retro-llamadas pueden ser algo asi: 

def datastore_created_cb(self , uid): 
new_jobject = datastore. get(uid) 
iter = self . ls_journal . append( ) 
title = new_jobject .metadata[ ' title ' ] 
self . ls_journal. set (iter, 

COLUMN_TITLE, title) 
mime = new_jobject .metaclata[ 'mime_type ' ] 
self .ls_journal. set (iter, 

COLUMN_MIME, mime) 
self .ls_j our nal. set (iter, 

COLUMN_JOBJECT, new_jobject) 
def datastore_updated_cb(self , uid): 
new_jobject = datastore . get(uid) 
iter = self . ls_journal . get_iter_first( ) 
for row in self .ls_journal: 

jobject = row[COLUMN_JOBJECT] 
if jobject . object_id == uid: 

title = new_jobject .metadata[ ' title ' ] 
self. ls_journal. set_value(iter, 

COLUMN_TITLE, title) 
break 
iter = self . ls_journal.iter_next (iter) 
object_id = \ 

self . selected_journal_entry . object_id 
if object_id == uid: 

self . set_form_fields(new_j object) 
def datastore_deleted_cb(self , uid): 
save_path = self . selected_path 
iter = self . ls_journal . get_iter_first( ) 
for row in self .ls_journal: 

jobject = row[COLUMN_JOBJECT] 
if jobject . object_id == uid: 

self. ls_journal. remove (iter) 
break 
iter = self . ls_journal. iter_next (iter ) 
try: 

self . selection_journal. select _path( 
save_path) 
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self . tv_ journal. grab_focus( ) 
except : 

self . title_entry . set_text( ' ' ) 
description_textbuffer = \ 

self. description_textview. get_buffer( ) 
description_textbuffer . set_text( ' ' ) 
tags_textbuffer = \ 

self. tags_textview. get_buffer( ) 
tags_textbuffer . set_text ( ' ' ) 
self . btn_save . props . sensitive = False 
self . btn_delete . props . sensitive = False 
self . image . clear( ) 
self . image . show( ) 

El uid que se asigna a cada retro-llamada es el id del objeto del Diario 
-object id que fue agregado, actualizado o borrado. Si se agrega una 
entrada al Diario obtenemos el objeto Journal desde su uid, y luego lo 
agregamos al gtk.ListStore para armar el gtk.TreeModel donde listamos 
las entradas segun el modelo arbol. Necesitamos llevar control cuando 
una entrada se actualiza o se borra para esto usamos el uid para 
descubrir cual renglon de la lista gtk.ListStore es necesario borrar o 
modificar. Para esto se itera sobre las entradas en la gtk.ListStore 
buscando coincidencias. 

Ahora ya sabes todo lo que puedes necesitar para trabajar con el Journal. 
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1. NT: El Gobierno estadounidense eligio en 1890 la maquina de 
Hollerith para elaborar un censo nacional — 

2. Traducido Ana Cichero, Uruguay revisado Rafael Ortiz, Colombia- 
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J. O • Construir Actividades con Pygame 

Introduccion 

PyGame y PyGTK son dos maneras distintas de crear un programa en 
Python con una interfaz grafica. En general no se usan ambas en un 
mismo programa. Cada una de ellas tiene su propia fornna de crear una 
ventana y gestionar los eventos. 

La clase basica Activity que hemos venido usando es una extension de la 
clase Ventana PyGTK y emplea la gestion de eventos de PyGTK. Las 
barras de herramientas empleadas por todas las Actividades son 
componentes PyGTK. En resumen, cualquier Actividad creada en Python 
debe usar PyGTK. Insertar un programa PyGame en el medio de un 
programa PyGTK se asemeja a colocar un modelo de barco dentro de 
una botella. Afortunadamente existe un codigo Python llamado 
SugarGame que lo hace posible. 

Antes de ver como lo colocamos dentro de la botella, veamos un poco 
mas de cerca nuestro barco modelo. 

Crear un programa con PyGame 

Como cabria esperar, es una buena idea construir un juego en Python 
usando Pygame antes de crear una Actividad con el. No soy un 
experimentado desarrollador en Pygame, pero usando el manual Rapid 
Game Development with Pytlion de Richard Jones en esta URL: 

http://richard.cgpublisher.com/product/pub.84/prod.ll 

Me fue posible crear un juego modesto en apenas un dia. Pudo haber 
sido antes, pero los ejemplos del manual contenian errores y requeri 
bastante tiempo usando Tlie GIMP para crear imagenes que pudieran 
servir de sprites en el juego. 

Los Sprites son pequehas imagenes, a menudo animadas, que 
representan objetos en un juego. En general tienen un fondo 
transparente que les permite dibujarse sobre una imagen de fondo. Use 
el formato PNG ya que el me permite usar un alpha channel (otro 
termino para decir que una parte de la imagen es transparente). 
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PyGame dispone de codigo para desplegar imagenes de fondo, para 
crear sprites y moverlos sobre el fondo elegido y para detectar cuando 
los sprites chocan entre si y hacer algo cuando esto sucede. Esta es la 
base para construir juegos en 2D. Existe una gran cantidad de juegos 
escritos con PyGame que pueden convertirse facilmente en actividades 
de Sugar. 

Mi juego se asemeja mucho al juego del autito en el manual, pero en 
lugar de un auto dibuje un avion. Este avion es el Demoiselle creado por 
Alberto Santos-Dumont en 1909. Encontraran tambien cuatro 
estudiantes de Otto Lilienthal que se sostienen en el aire gracias a sus 
"alas delta" (planeadores). Las alas delta caen cuando Santos-Dumont 
choca contra ellas. Los controles empleados en el juego fueron tambien 
modificados. Use las teclas " + " y "-" tanto en el teclado principal como el 
secundario, mas las teclas "9" y "3", para abrir y cerrar el acelerador asi 
como las teclas hacia arriba y hacia abajo en ambos teclados para mover 
el joystick hacia adelante y hacia atras. Usar el teclado secundario es util 
por un par de razones. Primero algunas versiones del sugar-emulator 
no reconocen las flechas del teclado principal. Segundo, las flechas del 
teclado se corresponden con el controlador de juego de la laptop XO y las 
teclas que no son flechas se corresponden con los otros botones en la 
pantalla de la XO. Estos botones pueden ser usados para jugar al juego 
cuando la XO esta en modo tablet. 

Como simulador de vuelo no es gran cosa, pero demuestra al menos 
algunas de las cosas que PyGame puede hacer. A continuacion les dejo el 
codigo del juego, al que Name Demoiselle: 

#! /usr/bin/env python 
import pygame 
import math 
import sys 

class Demoiselle: 

"This is a simple demonstration of using PyGame \ 
sprites and collision detection." 
def init (self): 

self . background = pygame . image . load( ' sky .jpg ' ) 

self. screen = pygame. display . get_surface( ) 

self . screen . blit(self . background, (0, 0)) 

self. clock = pygame . time . Clock( ) 

self. running = True 

gliders = [ 

GliderSprite((200, 200)), 

GliderSprite((800, 200)), 

GliderSprite((200, 600)), 

GliderSprite((800, 600)), 

] 

self. glider_group = pygame . sprite . RenderPlain( 
gliders) 

def run(self ) : 

"This method processes PyGame messages" 
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rect = self . screen . get_rect( ) 

airplane = AirplaneSprite( ' demoiselle . png ' , 

rect . center) 
airplane_sprite = pygame . sprite . RenderPlain( 

airplane) 

while self . running : 

self .clock. tick (30) 

for event in pygame. event . get () : 
if event. type == pygame. QUIT: 
self. running = False 
return 
elif event. type == pygame .VIDEORESIZE: 
pygame . display . set_mode( event .size, 

pygame. RESIZABLE) 
self. screen. blit (self. background, 
(0, 0)) 

if not hasattr(event, 'key'): 
continue 

down = event. type == pygame . KEYDOWN 

if event. key == pygame . K_DOWN or \ 
event. key == pygame . K_KP2 : 
airplane. joystick_back = down * 5 

elif event. key == pygame . K_UP or \ 
event. key == pygame. K_KP8 : 
airplane. joystick_forward = down * -5 

elif event. key == pygame . K_EQUALS or \ 
event. key == pygame. K_KP_PLUS or \ 
event. key == pygame. K_KP9 : 
airplane. throttle_up = down * 2 

elif event. key == pygame . K_MINUS or \ 
event. key == pygame. K_KP_MINUS or \ 
event. key == pygame. K_KP3 : 
airplane. throttle_down = down * -2 

self . glide r_g roup .clear( self. screen, 

self. background) 
air plan e_sp rite .clear( self. screen, 

self. background) 
collisions = pygame . sprite . spritecollide( 

airplane, 

self . glider_group. False) 
self . glide r_g roup .update(collisions) 
self . glide r_g roup .draw (self. screen) 
air plan e_sp rite . update ( ) 
air plan e_sp rite .draw (self. screen) 
pygame. display. flip() 

class AirplaneSprite( pygame. sprite. Sprite) : 

"This class represents an airplane, the Demoiselle \ 
created by Alberto Santos-Dumont" 
MAX_FORWARD_SPEED = 10 
MIN_FORWARD_SPEED = 1 
ACCELERATION = 2 
TURN_SPEED = 5 

def init (self, image, position): 

pygame. sprite .Sprite. init (self) 
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self . src_image = pygame . image .load (image) 
self.rect = pygame. Rect( 

self . src_image . get_rect( ) ) 
self . position = position 
self . rect . center = self . position 
self. speed = l 
self .direction = 
self . joystick_back = self . joystick_forward = \ 

self . throttle_down = self . throttle_up = 

def update(self ) : 

"This method redraws the airplane in responseX 

to events." 

self. speed += (self . throttle_up + 

self . throttle_down) 
if self. speed > self . MAX_FORWARD_SPEED: 

self. speed = self . MAX_FORWARD_SPEED 
if self. speed < self . MIN_FORWARD_SPEED: 

self. speed = self .MIN_FORWARD_SPEED 
self . direction += (self . joystick_forward + \ 

self . joystick_back) 
x_coord, y_coord = self . position 
rad = self . direction * math. pi / 180 
x_coord += -self. speed * math .cos( rad) 
y_coord += -self. speed * math . sin( rad) 
screen = pygame. display . get_surface( ) 
if y_coord < 0: 

y_coord = screen . get_height( ) 

if x_coord < 0: 

x_coord = screen . get_width( ) 

if x_coord > screen . get_width( ) : 
x_coord = 

if y_coord > screen . get_height( ) : 

y_coord = 
self . position = (x_coord, y_coord) 
self. image = pygame . transform. rotate( 

self . src_image, -self . direction) 
self.rect = self . image . get_rect( ) 
self . rect . center = self . position 

class GliderSprite( pygame .sprite. Sprite) : 

"This class represents an individual hang \ 
glider as developed by Otto Lilienthal." 
def init (self, position): 

pygame .sprite .Sprite. init (self) 

self. normal = pygame. image. load( 
' glider_normal . png ' ) 

self.rect = pygame . Rect (self . normal. get_rect( ) ) 

self . rect . center = position 

self-image = self. normal 

self. hit = pygame . image .load( ' glider_hit . png ' ) 
def update(self, hit_list): 

"This method redraws the glider when it collidesX 

with the airplane and when it is no longer \ 

colliding with the airplane." 

if self in hit list: 
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else ; 



self. image = self. hit 
self. image = self. normal 



def main( ) : 

"This function is called when the game is run \ 

from the command line" 

pygame . init( ) 

pygame . display . set_mode( (0, 0), pygame. RESIZABLE) 

game = Demoiselle() 

game. run( ) 

sys . exit(0) 



if 



name__ 

main( ) 



main 



Y aqui tenemos al juego en accion: 




Encontraran el codigo de este juego en el archive demoiselle.py que se 
encuentra en el libro de ejemplos del proyecto en Git. 



Introduccion a SugarGame 



SugarGame no es una parte de Sugar propiamente dicha. Si deseas 
usaria deberas incluir el codigo Python para SugarGame dentro del 
bundle de tu Actividad. Inclui la version de SugarGame que estoy usando 
en el proyecto del libro de ejemplos en el directorio sugargame, pero 
cuando hagas tus propios juegos deberias asegurarte de que dispones de 
la ultima version. Puedes hacer esto bajando el proyecto desde Gitorious 
empleando estos comandos: 
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mkdir sugargame 

cd sugargame 

git clone git : //git . sugarlabs .org/sugargame/mainline . git 

Veras dos subdirectories en este proyecto: sugargame y test, mas un 
archive README.txt que contiene informacion para usar sugargame en 
tus propias Actividades. El subdirectorio test contiene un sencillo 
programa PyGame que puede ser ejecutado solo (TestGame.py) o como 
una Actividad (TestActivity.py). 

Si ejecutas el TestGame.py desde la linea de comandos veras una 
pelota que rebota en un fondo bianco. Para ejecutar la version Actividad 
debes escribir: 

. /setup. py dev 

desde la linea de comandos. No pude hacer funcionar la Actividad bajo 
el emulador de Sugar hasta que realice los dos siguientes cambios: 

• Mice una copia del directorio sugargame dentro del directorio test. 

• Borre la linea que contenia "sys.path.append(..) # Import 
sugargame package from top directory." en el TestActivity.py. 

Obviamente, esta linea deberia ayudar al programa a encontrar el 
directorio sugargame en el proyecto, pero no funciono bajo Fedora 
10. Tu experiencia puede ser distinta. 

La Actividad se ve asi: 
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La barra de herramientas de PyGame tiene un solo boton que te 
permite hacer rebotar o detener la pelota. 

Crear una Actividad Sugar a partir de un programa 
PyGame. 

Llego el momento de poner nuestro modelo de barco en la botella. Lo 
primero es hacer una copia del directorio sugargame del proyecto 
SugarGame en el directorio raiz de nuestro propio proyecto. 

Vale la pena leer el archivo README.txt del proyecto SugarGame. Nos 
explica como crear una Actividad basada en el ejempio TestActivity.py 
en el proyecto Sugargame. Esta sera nuestra botella. El siguiente es el 
codigo para la mia, que Name DemoiselleActivity.py: 

# DemoiselleActivity.py 

from gettext import gettext as _ 

import gtk 

import pygame 

from sugar . activity import activity 

from sugar . graphics . toolbutton import ToolButton 

import gobject 

import sugargame . canvas 

import demoiselle2 

class DemoiselleActivity(activity .Activity) : 

def init (self, handle): 

super(DemoiselleActivity, self) . init (handle) 

# Build the activity toolbar, 
self. build_toolbar( ) 

# Create the game instance. 

self. game = demoiselle2 . Demoiselle( ) 

# Build the Pygame canvas, 
self ._pygamecanvas = \ 

sugargame. canvas. PygameCanvas(self) 

# Note that set_canvas implicitly calls 

# read_file when resuming from the Journal, 
self . set_canvas(self ._pygamecanvas) 

self . score = ' ' 

# Start the game running. 

self ._py game canvas . run_pygame(self . game. run) 

def build_toolbar(self ) : 

toolbox = activity .ActivityToolbox(self) 
activity_toolbar = toolbox. get_activity_toolbar( ) 
activity_toolbar . keep . props .visible = False 
activity_toolbar . share . props .visible = False 



self . view_toolbar = ViewToolbar( ) 
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toolbox. add_toolbar(_( 'View' ), self . view_toolbar ) 
self . view_toolbar . connect ( 'go-fullscreen' , 

self . view_toolbar_go_f ullscreen_cb) 
self . view_toolbar . show( ) 

toolbox. show( ) 

self. set_toolbox( toolbox) 

def view_toolbar_go_f ullscreen_cb(self , view_toolbar ) : 
self.fullscreen() 

def read_file(self , file_path): 

score_file = open(f ile_path, "r") 
while score_file: 

self. score = score_f ile . readline( ) 

self. game. set _score(int(self. score)) 
score_f ile . close( ) 

def write_file(self , file_path): 
score = self . game . get_score( ) 
f = open(f ile_path, 'wb') 
try: 

f.write(str(score)) 
finally: 

f . close 

class ViewToolbar(gtk .Toolbar ) : 

gtype_name = 'ViewToolbar ' 

gsignals = { 

' needs-update-size' : (gobject .SIGNAL_RUN_FIRST, 

gobject .TYPE_NONE, 

([])), 
'go-fullscreen' : (gobject .SIGNAL_RUN_FIRST, 
gobject .TYPE_NONE, 
([])) 
} 

def init (self): 

gtk. Toolbar . init (self) 

self .fullscreen = ToolButton( ' view-fullscreen ' ) 
self. fullscreen. set_tooltip(_( 'Fullscreen' )) 
self. fullscreen. connect ( 'clicked' , 

self . f ullscreen_cb) 
self . insert(self . fullscreen, -1) 
self.fullscreen.show() 

def f ullscreen_cb(self , button): 
self .emit( 'go-fullscreen' ) 

Es un poco mas "bonita" que TestActivity.py. Decidi que mi juego no 
necesitaba ser pausado y continuado, asi que remplace la barra de 
herramientas de PyGame con un una barra de herramientas View que 
le permite al usuario ocultar la barra cuando no es necesaria. Use los 
metodos read_file() y write_file() para guardar y recuperar el score del 
juego. Tambien oculte los controles Keep and Share en la barra 
principal. 
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Tal como podrias esperar, poner un barco dentro de una botella requiere 
modificar el barco. Esta es la nueva version, demoiselle2.py, que 
incluye las siguientes modificaciones: 

#! /usr/bin/env python 
import pygame 
import gtk 
import math 
import sys 

class Demoiselle: 

"This is a simple demonstration of using PyGame \ 
sprites and collision detection." 
def init (self): 

self. clock = pygame . time . Clock( ) 

self. running = True 

self . background = pygame . image . load( ' sky . jpg ' ) 

def get_score(self ) : 
return '99' 

def run(self ) : 

"This method processes PyGame messages" 

screen = pygame .display . get_surface( ) 
screen . blit (self . background, (0, 0)) 

gliders = [ 

GliderSprite((200, 200)), 

GliderSprite((800, 200)), 

GliderSprite((200, 600)), 

GliderSprite((800, 600)), 

] 

glider_group = pygame . sprite. RenderPlain(gliders) 

rect = screen . get_rect( ) 

airplane = AirplaneSprite( ' demoiselle . png ' , 

rect . center) 
airplane_sprite = pygame . sprite. RenderPlain( 

airplane) 

while self . running : 

self .clock. tick(30) 

# Pump GTK messages, 
while gtk . events_pending( ) : 

gtk .main_iteration( ) 

# Pump PyGame messages. 

for event in pygame .event . get () : 
if event. type == pygame. QUIT: 
self. running = False 
return 
elif event. type == pygame .VIDEORESIZE: 
pygame . display . set_mode( event .size, 

pygame. RESIZABLE) 
screen . blit(self. background, (0, 0)) 



if not hasattr(event, 'key') 
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continue 

down = event. type == pygame . KEYDOWN 

if event. key == pygame . K_DOWN or \ 
event. key == pygame. K_KP2 : 
airplane. joystick_back = down * 5 

elif event, key == pygame. K_L)P or \ 
event. key == pygame. K_KP8 : 
airplane. joystick_forward = down * -5 

elif event. key == pygame . K_EQUALS or \ 
event. key == pygame. K_KP_PLUS or \ 
event. key == pygame. K_KP9 : 
airplane. throttle_up = down * 2 

elif event. key == pygame . K_MINUS or \ 
event. key == pygame . K_KP_MINUS or \ 
event. key == pygame. K_KP3: 
airplane. throttle_down = down * -2 

glide r_g roup .clear( screen, self. background) 
air plan e_sp rite .clear( screen, self. background) 
collisions = pygame . sprite . spritecollide( 

airplane, 

glider_group. False) 
glide r_g roup .update(collisions) 
glide r_g roup .draw (screen) 
air plan e_sp rite . update( ) 
air plan e_sp rite .draw (screen) 
pygame. display. flip() 

class AirplaneSprite( pygame. sprite. Sprite) : 

"This class represents an airplane, the Demoiselle \ 

created by Alberto Santos-Dumont" 

MAX_FORWARD_SPEED = 10 

MIN_FORWARD_SPEED = 1 

ACCELERATION = 2 

TURN_SPEED = 5 

def init (self, image, position): 

pygame .sprite .Sprite. init (self) 

self . src_image = pygame . image .load(image) 

self.rect = pygame . Rect (self . src_image . get_rect( ) ) 

self . position = position 

self . rect . center = self . position 

self. speed = 1 

self .direction = 

self . joystick_back = self . joystick_forward = \ 
self . throttle_down = self . throttle_up = 

def update(self ) : 

"This method redraws the airplane in responseX 

to events." 

self. speed += (self . throttle_up + 

self . throttle_down) 
if self. speed > self . MAX_FORWARD_SPEED: 

self. speed = self . MAX_FORWARD_SPEED 
if self. speed < self . MIN_FORWARD_SPEED: 

self. speed = self .MIN_FORWARD_SPEED 
self . direction += (self . joystick_forward + 

self . joystick_back) 
x_coord, y_coord = self . position 
rad = self .direction * math. pi / 180 
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x_coord += -self. speed * math . cos( rad) 
y_coord += -self. speed * math . sin( rad) 
screen = pygame . display . get_surface( ) 
if y_coord < 0: 

y_coord = screen . get_height( ) 

if x_coord < 0: 

x_coord = screen . get_width( ) 

if x_coord > screen . get_width( ) : 
x_coord = 

if y_coord > screen . get_height( ) : 

y_coord = 
self . position = (x_coord, y_coord) 
self. image = pygame . transform. rotate( 

self . src_image, -self . direction) 
self.rect = self . image . get_rect( ) 
self . rect .center = self . position 

class GliderSprite( pygame. sprite. Sprite) : 

"This class represents an individual hang \ 
glider as developed by Otto Lilienthal." 

def init (self, position): 

pygame. sprite .Sprite. init (self) 

self. normal = pygame. image .load( 

' glider_normal. png ' ) 
self.rect = pygame . Rect(self. normal . get_rect( ) ) 
self . rect .center = position 
self. image = self. normal 

self. hit = pygame . image .load( ' glider_hit . png ' ) 
def update(self, hit_list): 

"This method redraws the glider when it collidesX 
with the airplane and when it is no longer \ 
colliding with the airplane." 
if self in hit_list: 

self. image = self. hit 
else : 

self. image = self. normal 

def main( ) : 

"This function is called when the game is run \ 

from the command line" 

pygame . init( ) 

pygame . display . set_mode( (0, 0), pygame . RESIZABLE) 

game = Demoiselle() 

game . run( ) 

sys . exit(0) 

if name == ' main ' : 

main( ) 

iPor que no cargar ambas versiones demoiselle.py y demoiselle2.py 

en Eric y tomar unos pocos minutos para ver si puedes encontrar que 
cambio entre ellas? Sorprendentemente, las diferencias son muy pocas. 
Agregue algo de codigo al bucle principal de PyGame para verificar 
eventos de PyGTK y lidiar con ellos: 
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while self . running : 

self .clock. tick(30) 

# Pump GTK messages, 
while gtk.events_pending( ) : 

gtk.main_iteration( ) 

# Pump PyGame messages. 

for event in pygame .event .get( ) : 
if event. type == pygame. QUIT: 
self. running = False 
return 
elif event. type == pygame .VIDEORESIZE: 
pygame .display. set_mode( event .size, 

pygame. RESIZABLE) 
screen . blit (self . background, (0, 0)) 

if not hasattr(event, 'key'): 

continue 
down = event. type == pygame . KEYDOWN 
if event. key == pygame . K_DOWN or \ 

. . . continue dealing with PyGame events . . . 

Esto permite que PyGame y PyGTK se alternen gestionando eventos. Si 
este codigo no estuviera presente, los eventos de GTK serian ignorados y 
seria imposible cerrar la Actividad, ocultar la barra de herramientas, etc. 
Necesitamos agregar import gtk al comienzo del archivo para que 
estos metodos puedan ser encontrados. 

Evidentemente, tambien agregue los metodos para fijar y devolver 
scores: 

def get_score(self ) : 
return self. score 

def set_score(self , score): 
self. score = score 

El mayor cambio esta en el metodo init () de la clase Demoiselle. Al 

principio tenia codigo para mostrar la imagen del fondo en la pantalla: 

def init (self): 

self . background = pygame . image . load( ' sky .jpg ' ) 
self. screen = pygame. display . get_surface( ) 
self . screen . blit(self . background, (0, 0)) 

El problema con esto es que sugargame creara un objeto PyGTK de 
pantalla especial para remplazar la pantalla de PyGame antes que lo 
haga el codigo de la Actividad Demoiselle, por lo que self.screen tendra 
valor "nulo". La unica forma de superar este problema es mover 

cualquier codigo que se refiera al display out del metodo init () de 

la clase y al principio del metodo que contiene el bucle del evento. Esto 

te puede dejar con un metodo init () que hace poco o nada. Lo unico 

que puedes querer es codigo para crear variables de instancias. 
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Nada de lo que hemos hecho a demoiselle2.py inhibe la posibilidad de 
ejecutarlo como un programa Python independiente. 

Para probar el juego ejecuta ./setup. py dev desde el directorio 
Making_Activities_Using_PyGame. Cuando pruebes la Actividad se 
deberia ver asi: 




1. Traducido Fernando Cormenzana, Uruguay- 
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A V« Hacer nuevas barras de 
herramientas 



Introduccion. 

Algunos dicen "No hay mejor barra de herramientas que tu vieja y 
conocida barra de herramientas". Esto sera totalmente cierto cuando se 
trate de usuarios que no puedan ejecutar la ultima versionde Sugar. Las 
actividades deben, por algun tiempo, soportar las barras de 
herramientas del primer Sugar. Afortunadamente, esto es posible. En 
este capitulo veremos como hacer nuevas barras y lograr que tu 
Actividad sea compatible con versiones anteriores. 

Las nuevas toolbars o barras de herramientas surgieron a raiz de los 
problemas con las anteriores. Los usuarios perdian tiempo en descubrir 
como parar una Actividad porque el boton Detener solo se veia en la 
Barra de Actividad. Si la Actividad se iniciaba mostrando una barra 
diferente a esta, no era obvio tener que cambiar a otra barra para quitar 
la Actividad. Otro problema era que las pestahas de las barras ocupaban 
demasiado espacio de pantalla. Comparemos barras de herramientas 
para actividades similares. Primero la barra al viejo estilo para Read 
Etexts: 



O Of 


^ni5 if ^ 


ACCivitt- 1 Edit ^ 


^m,W!M^B^Mm:. 


Ahora la barra en el nuevo estilo para la Actividad Leer: 




■1 




B/136 if Q 



Esta es mas delgada que las del tipo anterior y el boton Detener esta 
siempre visible. Algunas funciones se ven en la barra y otras aparecen 
en barras adjuntas que se despliegan al hacer die sobre los iconos. 
Veamos primero como se despliega la nueva Barra de Actividad (Activity 
Toolbar): 
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Veamos la nueva barra de Edicion (Edit Toolbar): 





1 ^ ^ 0S>/i3' it 


o 


Hia rr^^^^ 


Por ultimo la barra de Vista (View Toolbar): 
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o 
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Agregar barras de herramientas del nuevo tipo en Read 
Etexts II 

Al trabajar en la Actividad Read Etexts original utilice un monton del 
codigo para la interfaz de usuario de la Actividad Leer original y no hay a 
priori ningun motivo para dejar de hacerlo. Sin embargo aparece una 
complicacion al hacer esto. La Actividad Leer tiene algunas 
dependencias que hacen que no funcione sobre las versiones viejas de 
Sugar y entonces no tiene necesidad de soportar compatibilidad con 
barras de herramientas del viejo estilo. Read Etexts IV no tiene esta 
suerte y debera descubrir al ejecutar cual es el tipo de barra de 
herramientas soportado y entonces usarlo. 

Puedo probar la Actividad con ambas tipos de barras de herramientas, 
viejas y nuevas en un mismo bloque porque estoy usando Fedora 11 que 
trae instalado un entorno Sugar que soporta del viejo estilo de barras y 
ademas descargue y ejecute sugar-jhbuild que agrega el soporte para 
las barras nuevas en su version de Sugar. 

Este es el codigo para ReadEtextsActivity4.py: 

import OS 

import re 

import logging 

import time 

import zipfile 

import gtk 

import pango 

import dbus 

import gobject 

import telepathy 

from sugar . activity import activity 

from sugar . graphics . toolbutton import ToolButton 
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_NEW_TOOLBAR_SUPPORT = True 

try: 

from sugar . graphics . toolbarbox import ToolbarBox 
from sugar . graphics . toolbarbox import ToolbarButton 
from sugar . activity .widgets import StopButton 
from toolbar import ViewToolbar 
from mybutton import MyActivityToolbarButton 

except : 

_NEW_TOOLBAR_SUPPORT = False 

from toolbar import ReadToolbar, ViewToolbar 

from sugar . graphics . toggletoolbutton import ToggleToolButton 
from sugar . graphics .menuitem import Menultem 

from sugar . graphics import style 

from sugar import network 

from sugar . datastore import datastore 

from sugar . graphics . alert import NotifyAlert 

from gettext import gettext as _ 

page=0 

PAGE_SIZE = 45 
TOOLBAR_READ = 2 

logger = logging . getLogger( ' read-etexts2-activity ' ) 

class ReadHTTPRequestHandler( 

network . ChunkedGlibHTTPRequest Handler) : 

"""HTTP Request Handler for transferring document while 

collaborating . 

RequestHandler class that integrates with Glib mainloop. 
It writes the specified file to the client in chunks, 
returning control to the mainloop between chunks. 



def translate_path(self , path): 

"""Return the filepath to the shared document.""" 
return self . server .filepath 



class ReadHTTPServer(network.GlibTCPServer) : 

"""HTTP Server for transferring document while 
collaborating . """ 

def init (self, server_address, filepath): 

"""Set up the GlibTCPServer with the 
ReadHTTPRequestHandler . 

filepath -- path to shared document to be served, 

ri t[ M 

self .filepath = filepath 

network. GlibTCPServer . init (self, 

server_address, 

ReadHTTPRequestHandler) 



class ReadURLDownloader(network.GlibURLDownloader) 
"""URLDownloader that provides content-length 
and content-type.""" 
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def get_content_length(self ) : 

"""Return the content-length of the download.""" 
if self._info is not None: 

return int( self. _info. headers. get( 
'Content-Length' ) ) 

def get_content_type(self ) : 

"""Return the content-type of the download.""" 
if self._info is not None: 

return self. _info. headers. get ( 'Content-type' ) 
return None 

READ_STREAM_SERVICE = ' read -etexts-activity- http ' 

class ReadEtextsActivity(activity .Activity) : 

def init (self, handle): 

"The entry point to the Activity" 

global page 

activity .Activity . init (self, handle) 

self .fileserver = None 

self .object_id = handle . object_id 

if _NEW_TOOLBAR_SUPPORT: 

self . create_new_toolbar( ) 
else : 

self . create_old_toolbar( ) 

self . scrolled_window = gtk .ScrolledWindow( ) 

self . scrolled_window. set_policy(gtk . POLICY_NEVER, 

gtk.POLICY_AUTOMATIC) 
self . scrolled_window. props . shadow_type = \ 

gtk.SHADOW_NONE 

self . textview = gtk .TextView( ) 
self.textview. set_editable( False) 
self. textview. set_cur so r_visible( False) 
self. textview. set_lef t_margin(50) 
self. textview. connect( "key_press_event", 
self . keypress_cb) 

self . progressbar = gtk . ProgressBar( ) 
self.progressbar. set_orientation( 

gtk . PROGRESS_LEFT_TO_RIGHT) 
self. progressbar. set_f raction(0. 0) 

self . scrolled_window. add (self .textview) 

self. textview. show() 

self . scrolled_window. show( ) 

vbox = gtk.VBox() 

vbox. pack_start(self . progressbar. False, 

False, 10) 
vbox. pack_start(self . scrolled_window) 
self . set_canvas(vbox) 
vbox. show( ) 

page = 
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self .clipboard = gtk.Clipboard( 

display=gtk. gdk . display_get_default ( ) , 
selection="CLIPBOARD" ) 

self. text view. grab_focus( ) 

self .font_desc = pango . FontDescription( 
"sans %d" % style . zoom(10) ) 

self. text view. modify_font (self . f ont_desc) 

buffer = self . textview. get_buffer( ) 
self .markset_id = buffer . connect( "mark-set", 
self .mark_set_cb) 

self . unused_download_tubes = set() 

self .want_document = True 

self . download_content_length = 

self . download_content_type = None 

# Status of temp file used for write_file: 

self . tempf ile = None 

self .close_requested = False 

self. connect ("shared", self. shared_cb) 

self . is_received_document = False 

if self ._shared_activity and \ 
handle . object_id == None: 

# We're joining, and we don't already have 

# the document. 

if self . get_shared( ) : 

# Already joined for some reason, 

# just get the document 
self .joined_cb (self ) 

else : 

# Wait for a successful join before 

# trying to get the document 

self. connect ("joined", self. joined_cb) 

def create_old_toolbar(self ) : 

toolbox = activity .ActivityToolbox(self) 
activity_toolbar = toolbox. get_activity_toolbar ( ) 
activity_toolbar . keep . props .visible = False 

self .edit_toolbar = activity . EditToolbar( ) 
self .edit_toolbar . undo . props .visible = False 
self .edit_toolbar . redo . props .visible = False 
self .edit_toolbar . separator . props .visible = False 
self .edit_toolbar .copy. set_sensitive( False) 
self .edit_toolbar .copy.connect( 'clicked', 

self . edit_toolbar_copy_cb) 
self .edit_toolbar . paste . props .visible = False 
toolbox. ad d_toolbar(_( 'Edit'), self. edit_toolbar ) 
self .edit_toolbar . show( ) 

self . read_toolbar = ReadToolbar ( ) 

toolbox. add_toolbar(_( ' Read ' ) , self . read_toolbar ) 

self. read_toolbar .bacl<.connect( 'clicked', 

self . go_back_cb) 
self. read_toolbar .forward.connect( 'clicked', 

self . go_f orward_cb) 
self. read_toolbar . num_page_entry. connect ( ' activate ' , 
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self . num_page_entry_activate_cb) 
self . read_toolbar . show( ) 

self . view_toolbar = ViewToolbar( ) 

toolbox. add_toolbar(_( 'View' ), self . view_toolbar ) 

self . view_toolbar . connect ( 'go-fullscreen' , 

self . view_toolbar_go_f ullscreen_cb) 
self . view_toolbar . zoom_in .connect( 'clicked' , 

self . zoom_in_cb) 
self . view_toolbar . zoom_out .connect( 'clicked', 

self . zoom_out_cb) 
self . view_toolbar . show( ) 

self . set_toolbox( toolbox) 

toolbox. show( ) 

self . toolbox. set_current_toolbar(TOOLBAR_READ) 

def create_new_toolbar(self ) : 
toolbar_box = ToolbarBox() 

activity_button = MyActivityToolbarButton(self ) 
toolbar_box .toolbar . insert (activity_but ton, 0) 
activity_button . show( ) 

self .edit_toolbar = activity . EditToolbar( ) 
self .edit_toolbar . undo . props .visible = False 
self .edit_toolbar . redo . props .visible = False 
self .edit_toolbar . separator . props .visible = False 
self .edit_toolbar .copy. set_sensitive( False) 
self .edit_toolbar .copy.connect('clicl<ed', 

self . edit_toolbar_copy_cb) 
self . edit_toolbar . paste . props .visible = False 

edit_toolbar_button = ToolbarButton( 

page=self . edit_toolbar, 

icon_name= 'toolbar-edit' ) 
self .edit_toolbar . show( ) 

toolbar_box .toolbar . insert (edit_toolbar_button, -1) 
edit_toolbar_button . show( ) 

self . view_toolbar = ViewToolbar( ) 

self . view_toolbar . connect ( 'go-fullscreen' , 

self . view_toolbar_go_f ullscreen_cb) 
self . view_toolbar . zoom_in . connect ( ' clicked ' , 

self . zoom_in_cb) 
self . view_toolbar . zoom_out .connect( 'clicked', 

self . zoom_out_cb) 
self . view_toolbar . show( ) 
view_toolbar_button = ToolbarButton( 

page=self . view_toolbar, 

icon_name= 'toolbar-view' ) 
toolbar_box .toolbar . insert (view_toolbar_button, -1) 
view_toolbar_button . show( ) 

self. back = ToolButton( ' go-previous ' ) 

self . back. set_tooltip(_( ' Back ' ) ) 

self . back. props . sensitive = False 

self. back. connect( 'clicked' , self. go_back_cb) 

toolbar_box . toolbar. insert(self. back, -1) 
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self. back. show( ) 

self .forward = ToolButton( ' go-next ' ) 
self. for ward. set_tooltip(_( ' Forward ' ) ) 
self .forward . props . sensitive = False 
self. for ward. connect ( 'clicked' , 

self . go_f orward_cb) 
toolbar_box . toolbar. insert(self. for ward, -1) 
self .forward . show( ) 

num_page_item = gtk .ToolItem( ) 
self . num_page_entry = gtk.Entry() 
self. num_page_entry . set_text ( ' ' ) 
self. num_page_entry . set_alignment(l) 
self. num_page_entry . connect( 'insert-text' , 

self . new_num_page_entry_insert_text_cb) 

self. num_page_entry . connect( 'activate' , 

self . new_num_page_entry_activate_cb) 

self. num_page_entry . set_width_chars(4) 
num_page_item. add ( self . num_page_entry) 
self. num_page_entry . show( ) 

toolbar_box .toolbar . insert (num_page_item, -1) 
num_page_item . show( ) 

total_page_item = gtk .ToolItem( ) 
self . total_page_label = gtk.Label() 

label_attributes = pango . AttrList( ) 
label_at tributes .insert (pango. At trSize( 

14000, 0, -1)) 
label_at tributes .insert (pango. At trForeground( 

65535, 65535, 65535, 0, -1)) 
self. total_page_label. set_attributes( 

label_at tributes) 

self . total_page_label. set_text( ' / 0') 
total_page_item. add ( self . total_page_label) 
self . total_page_label . show( ) 

toolbar_box .toolbar . insert (total_page_item, -1) 
total_page_item. show( ) 

separator = gtk. SeparatorToolItem( ) 
separator . props . draw = False 
separator. set_expand(True) 
toolbar_box . toolbar. insert(separator, -1) 
separator . show( ) 

stop_button = StopButton(self ) 

stop_button . props . accelerator = ' <Ctrl><Shif t>Q' 
toolbar_box .toolbar . insert (stop_button, -1) 
stop_button . show( ) 

self. set_toolbar_box( toolbar_box) 
toolbar_box . show( ) 

def new_num_page_entry_insert_text_cb(self , entry, 

text, length, position): 

if not re.match( ' [0-9] ' , text): 

entry. emit_stop_by_name( 'insert-text' ) 
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return True 
return False 

def new_num_page_entry_activate_cb(self , entry) 

global page 

if entry . props . text : 

new_page = int(entry. props . text) - 1 
else : 

new_page = 

if new_page >= self . total_pages : 

new_page = self . total_pages - 1 

elif new_page < 0: 
new_page = 

self .current_page = new_page 

self . set_current_page(new_page) 

self . show_page(new_page) 

entry . props . text = str(new_page + 1) 

self. update_nav_buttons( ) 

page = new_page 

def update_nav_buttons(self ) : 

current_page = self . current_page 

self . back. props . sensitive = current_page > 

self .forward . props . sensitive = \ 

current_page < self . total_pages - 1 

self . num_page_entry. props . text = str( 

current_page + 1) 
self . total_page_label. props . label = \ 

' / ' + str(self . total_pages) 

def set_total_pages(self , pages): 
self . total_pages = pages 

def set_current_page(self , page): 
self .current_page = page 
self . update_nav_buttons( ) 

def keypress_cb(self , widget, event): 

"Respond when the user presses one of the \ 

arrow keys" 

keyname = gtk . gdk. keyval_name(event . keyval) 

print keyname 

if keyname == 'plus': 

self . font_increase( ) 

return True 
if keyname == 'minus': 

self . font_decrease( ) 

return True 
if keyname == 'Page_Up' : 

self . page_previous( ) 

return True 
if keyname == 'Page_Down': 

self . page_next( ) 

return True 
if keyname == 'Up' or keyname == 'KP_Up' \ 
or keyname == 'KP_Left': 
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self . scroll_up( ) 

return True 
if keyname == 'Down' or keyname == ' KP_Down ' \ 
or keyname == 'KP_Right': 

self . scroll_down( ) 

return True 
return False 

def num_page_entry_activate_cb(self , entry): 
global page 
if entry . props . text : 

new_page = int(entry. props . text) - 1 
else: 

new_page = 

if new_page >= self . read_toolbar . total_pages : 

new_page = self . read_toolbar . total_pages - 1 

elif new_page < 0: 
new_page = 

self . read_toolbar . current_page = new_page 

self. read_toolbar . set_current_page(new_page) 

self. show_page(new_page) 

entry . props . text = str(new_page + 1) 

self. read_toolbar . update_nav_buttons( ) 

page = new_page 

def go_back_cb(self , button): 
self. page_previous( ) 

def go_forward_cb(self , button): 
self. page_next ( ) 

def page_previous(self ) : 
global page 
page=page-l 
if page < 0: page=0 
if _NEW_TOOLBAR_SUPPORT: 

self . set_current_page(page) 
else: 

self . read_toolbar . set_current_page(page) 
self. show_page(page) 
v_adjustment = \ 

self . scrolled_window. get_vad just men t( ) 
v_adjustment .value = v_adjustment . upper - \ 

v_adjustment . page_size 

def page_next (self ) : 
global page 
page=page+l 

if page >= len(self . page_index) : page=0 
if _NEW_TOOLBAR_SUPPORT: 

self . set_current_page(page) 
else: 

self . read_toolbar . set_current_page(page) 
self. show_page(page) 
v_adjustment = \ 

self . scrolled_window. get_vad just men t( ) 
v_adjustment .value = v_adjustment . lower 
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def zoom_in_cb(self , button): 
self . font_increase( ) 

def zoom_out_cb(self , button): 
self .f on t_decr ease ( ) 

def font_decrease(self ) : 

font_size = self . f ont_desc. get_size( ) / 1024 
font_size = font_size - 1 
if font_size < 1: 
font_size = 1 
self .font_desc. set_size(font_size * 1024) 
self . textview.modify_font (self . font_desc) 

def font_increase(self ) : 

font_size = self . f ont_desc. get_size( ) / 1024 
font_size = font_size + 1 
self .font_desc . set_size(font_size * 1024) 
self . textview.modify_font (self . font_desc) 

def mark_set_cb(self , textbuffer, iter, textmark) : 

if textbuffer. get_has_selection( ) : 

begin, end = textbuffer . get_selection_bounds( ) 
self . edit_toolbar .copy. set _sensitive(True) 

else : 

self . edit_toolbar .copy. set _sensitive(False) 

def edit_toolbar_copy_cb(self , button): 

textbuffer = self . textview. get_buffer( ) 
begin, end = textbuffer . get_selection_bounds( ) 
copy_text = textbuffer . get_text(begin, end) 
self. clipboard. set_text(copy_text ) 

def view_toolbar_go_f ullscreen_cb(self , view_toolbar ) : 
self . f ullscreen( ) 

def scroll_down(self ) : 
v_adjustment = \ 

self . scrolled_window. get_vadjustment( ) 
if v_adjustment .value == v_adjustment . upper - \ 
v_adj ustment . page_size : 
self . page_next( ) 
return 
if v_adj ustment .value < v_adjustment . upper - \ 
v_adj ustment . page_size : 
new_value = v_adjustment .value + \ 

v_adj ustment . step_increment 
if new_value > v_adj ustment . upper - \ 
v_adj ustment . page_size : 
new_value = v_adjustment . upper - \ 
v_adj ustment . page_size 
v_adj ustment .value = new_value 

def scroll_up(self ) : 
v_adjustment = \ 

self . scrolled_window. get_vadj ustment ( ) 
if v_adjustment .value == v_adjustment .lower : 
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self . page_previous( ) 
return 
if v_adjustment .value > v_adjustment . lower : 
new_value = v_adjustment .value - \ 

v_adjustment . step_increment 
if new_value < v_adjustment . lower : 

new_value = v_adjustment . lower 
v_adjustment .value = new_value 

def show_page(self , page_number) : 

global PAGE_SIZE, current_word 

position = self . page_index[page_number] 

self .etext_file. seek(position) 

linecount = 

label_text = '\n\n\n' 

textbuffer = self . textview. get_buffer( ) 

while linecount < PAGE_SIZE: 

line = self . etext_file. readline( ) 
label_text = label_text + unicode(line, 

'iso-8859-1' ) 
linecount = linecount + 1 

label_text = label_text + '\n\n\n' 

textbuffer . set_text(label_text) 

self. textview. set_buffer(textbuffer) 

def save_extracted_f ile(self , zipfile, filename): 

"Extract the file to a temp directory for viewing" 
filebytes = zipfile . read(filename) 
outfn = self .make_new_filename(f ilename) 
if (outfn == ' ' ) : 

return False 
f = open(os . path . join(self . get_activity_root ( ) , 

'tmp', outfn), 'w') 
try: 

f.write(file bytes) 
finally: 

f . close( ) 

def get_saved_page_number(self ) : 
global page 

title = self .metadata. get('title' , '') 
if title == '' or not title[len( title) -1] . isdigit( ) : 

page = 
else: 

i = len(title) - 1 
newPage = ' ' 

while (title[i] . isdigit( ) and i > 0) : 
newPage = title[i] + newPage 
i = i - 1 
if title[i] == 'P' : 

page = int(newPage) - 1 
else : 

# not a page number; maybe a volume number, 
page = 

def save_page_number(self ) : 
global page 

title = self .metadata. get('title' , '') 
if title == ' ' or not title[len(title) -1] . isdigit ( ) 
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title = title + ' p' + str(page + 1) 
else : 

i = len(title) - 1 

while (title[i] . isdigitO and i > 0) : 

i = i - 1 
if title[i] == 'P' : 

title = title[0:i] + 'P' + str(page + 1) 
else : 

title = title + ' p' + str(page + 1) 
self .metadata[ 'title'] = title 

def read_file(self , filename): 
"Read the Etext file" 
global PAGE_SIZE, page 

tempfile = os . path . join(self . get_activity_root( ), 

'instance', 'tmp%i' % time.time()) 
OS . link(filename, tempfile) 
self . tempfile = tempfile 

if zipf ile . is_zipf ile(filename) : 

self.zf = zipf ile .ZipFile(filename, 'r') 
self . book_f iles = self .zf . namelist( ) 
self . save_extracted_file(self . zf , 

self. book_files[0] ) 
currentFileName = os . path . join( 
self . get_activity_root ( ) , 
'tmp', self . book_files[0] ) 
else : 

currentFileName = filename 

self .etext_file = open(currentFileName, "r" ) 

self . page_index = [ ] 

pagecount = 

linecount = 

while self . etext_f ile : 

line = self . etext_f ile . readline( ) 
if not line: 

break 
linecount = linecount + 1 
if linecount >= PAGE_SIZE: 

position = self .etext_file. tell( ) 
self. page_index. append(position) 
linecount = 
pagecount = pagecount + 1 
if filename . endswith( ". zip" ) : 

OS . remove (currentFileName) 
self . get_saved_page_number( ) 
self . show_page(page) 
if _NEW_TOOLBAR_SUPPORT: 

self . set_total_pages(pagecount + 1) 
self . set_current_page(page) 
else : 

self . read_toolbar . set_total_pages( 

pagecount + 1) 
self . read_toolbar . set_current_page(page) 

# We've got the document, so if we're a shared 

# activity, offer it 
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if self . get_shared( ) : 

self .watch_for_tubes( ) 
self . share_document ( ) 

def make_new_f ilename(self , filename): 

partition_tuple = filename. rpartition( '/' ) 
return partition_tuple[2] 

def write_file(self , filename): 

"Save meta data for the file." 
if self .is_received_document : 

# This document was given to us by someone, 

# so we have to save it to the Journal. 
self.etext_file.seek(0) 

filebytes = self . etext_file. read( ) 
print 'saving shared document' 
f = open(filename, 'wb') 
try: 

f.write(filebytes) 
finally: 

f . close( ) 
elif self . tempfile: 

if self . close_requested : 

OS .link(self. tempfile, filename) 
logger . debug( 

"Removing temp file %s because " 
"we will close", 
self . tempfile) 
OS. unlink( self. tempfile) 
self . tempfile = None 
else: 

# skip saving empty file 
raise NotlmplementedError 

self .metadata[ ' activity ' ] = self . get_bundle_id( ) 
self. save_page_number( ) 

def can_close(self ) : 

self .close_requested = True 
return True 

def joined_cb(self , also_self): 

"""Callback for when a shared activity is joined. 

Get the shared document from another participant. 

ri t[ M 

self .watch_for_tubes( ) 

gobject . idle_add(self .get_document) 

def get_document (self ) : 

if not self .want_clocument : 
return False 

# Assign a file path to download if one 

# doesn't exist yet 

if not self ._jobject . file_path : 

path = OS . path . join(self . get_activity_root( ), 
'instance', 'tmp%i' % time.time()) 
else: 
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path = self ._jobject . f ile_path 

# Pick an arbitrary tube we can try to download 

# the document from 
try: 

tube_id = self . unused_download_tubes . pop( ) 
except (ValueError, KeyError), e: 
logger . debug( 

'No tubes to get the document from ' 

'right now: %s ' , e) 
return False 

# Avoid trying to download the document 

# multiple times at once 
self . want_document = False 

gobject .idle_add(self . download_document, 

tube_id, path) 
return False 

def download_document (self , tube_id, path): 

Chan = self ._shared_activity . telepathy_tubes_chan 
iface = chan[telepathy.CHANNEL_TYPE_TUBES] 
addr = iface .AcceptStreamTube(tube_id, 
telepathy . S0CKET_ADDRESS_TYPE_IPV4, 
telepathy . SOCKET_ACCESS_CONTROL_LOCALHOST, 

0, 

utf 8_st rings =T rue) 
logger . debug( 

'Accepted stream tube: ' 

'listening address is %r ' , 

addr) 
assert isinstance(addr, dbus. Struct) 
assert len(addr) == 2 
assert isinstance(addr [0] , str) 
assert isinstance(addr [1] , (int, long)) 
assert addr[l] > and addr[l] < 65536 
port = int(addr [1] ) 

self.progressbar.show() 
getter = ReadURLDownloader( 

"http://%s:%d/document" 

% (addr[0], port)) 
getter. connect(" finished", 

self . download_result_cb, tube_id) 
getter. connect ("progress", 

self . download_progress_cb, tube_id) 
getter. connect ("error", 

self . download_error_cb, tube_id) 
logger . debug( "Starting download to %s...", path) 
getter. start(path) 
self . download_content_length = \ 

getter . get_content_length( ) 
self . download_content_type = \ 

getter . get_content_type( ) 
return False 

def download_progress_cb(self , getter, 
bytes_downloaded, tube_id): 
if self . download_content_length > 0: 
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logger . debug( 

"Downloaded %u of %u bytes from tube %u . 
bytes_downloaded, 
self .download_content_length, 
tube_id) 
else: 

logger . debug( 

"Downloaded %u bytes from tube %u...", 
bytes_downloaded, tube_id) 
total = self .download_content_length 
self. set_downloaded_bytes(bytes_downloaded, 

total) 
gtk. gdk. threads_enter( ) 
while gtk. events_pending( ) : 

gtk.main_iteration( ) 
gtk . gdk. threads_leave( ) 

def set_downloaded_bytes(self , bytes, total): 
fraction = float(bytes) / float(total) 
self.progressbar. set_fraction( fraction) 
logger . debug( "Downloaded percent", fraction) 

def clear_downloaded_bytes(self ) : 

self.progressbar. set_f raction(0.0) 
logger . debug( "Cleared download bytes") 

def download_error_cb(self , getter, err, tube_id): 
self.progressbar.hide() 
logger . debug( 

"Error getting document from tube %u : %s", 

tube_id, err) 
self.alert(_( 'Failure' ), 

_( 'Error getting document from tube')) 
self .want_document = True 
self .download_content_length = 
self . download_content_type = None 
gobject . idle_add(self .get_document) 

def download_result_cb(self , getter, tempfile, 
suggested_name, tube_id): 
if self .download_con ten t_type . startswith( 
'text/html' ) : 

# got an error page instead 
self . download_error_cb( getter, 

'HTTP Error', tube_id) 
return 

del self . unused_download_tubes 

self . tempfile = tempfile 
file_path = os . path . join( 

self . get_activity_root( ), 

'instance', '%i' % time.time()) 
logger . debug( 

"Saving file %s to datastore . . . ", file_path) 
OS . link(tempf ile, file_path) 
self ._jobject . file_path = file_path 
datastore. write(self._j object, 

transf er_ownership=True) 
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logger . debug( "Got document %s (%s) from tube %u' 

tempfile, suggested_name, tube_id) 
self .is_received_document = True 
self . read_file( tempfile) 
self . save( ) 
self.progressbar.hide() 

def shared_cb(self , activityid): 

"""Callback when activity shared. 

Set up to share the document. 



# We initiated this activity and have now 

# shared it, so by definition we have the file, 
logger . debug( 'Activity became shared') 

self .watch_for_tubes( ) 
self . share_document( ) 

def share_document (self ) : 

"""Share the document. """ 
h = hash(self ._activity_id) 
port = 1024 + (h % 64511) 
logger . debug( 

'Starting HTTP server on port %d ' , port) 
self .fileserver = ReadHTTPServer( ( "", port), 
self . tempfile) 

# Make a tube for it 

Chan = self ._shared_activity . telepathy_tubes_chan 
iface = chan[telepathy.CHANNEL_TYPE_TUBES] 
self .fileserver_tube_id = iface. OfferStreamTube( 
READ_STREAM_SERVICE, 

{}, 

telepathy . S0CKET_ADDRESS_TYPE_IPV4, 

( '127.0.0.1' , dbus.UIntl6(port)), 

telepathy. SOCKET_ACCESS_CONTROL_LOCALHOST, 0) 

def watch_f or_tubes(self ) : 

"""Watch for new tubes.""" 
tubes_chan = \ 

self ._shared_activity . telepathy_tubes_chan 

tubes_chan[telepathy.CHANNEL_TYPE_TUBES] .\ 

connect_to_signal( 

' NewTube ' , 

self . new_tube_cb) 
tubes_chan[telepathy .CHANNEL_TYPE_TUBES] . ListTubes( 

reply_handler=self . list_tubes_reply_cb, 

error_handler=self . list_tubes_error_cb) 

def new_tube_cb(self , tube_id, initiator, tube_type, 
service, params, state): 

"""Callback when a new tube becomes available.""" 
logger . debug( 

'New tube: ID=%d initator=%d type=%d service=%s 

' params=%r state=%d', tube_id, 

initiator, tube_type. 



244 



service, params, state) 
if service == READ_STREAM_SERVICE: 

logger .debug( ' I could download from that tube') 
self . unused_clownload_tubes . add(tube_id) 

# if no download is in progress, let's 

# fetch the document 
if self .want_document : 

gobject . idle_add(self .get_document ) 

def list_tubes_reply_cb(self , tubes): 

"""Callback when new tubes are available.""" 
for tube_info in tubes: 

self . new_tube_cb(*tube_info) 

def list_tubes_error_cb(self , e): 

"""Handle ListTubes error by logging.""" 
logger . error (' ListTubes( ) failed: %s ' , e) 

def alert(self, title, text=None) : 
alert = NotifyAlert(timeout=20) 
alert . props . title = title 
alert . props .msg = text 
self . ad d_alert( alert ) 

alert .connect( 'response', self. alert_cancel_cb) 
alert . show( ) 

def alert_cancel_cb(self , alert, response_id) : 
self. remove_alert (alert ) 
self. text view. grab_focus( ) 

Asi es como se ve si corro el codigo bajo sugar-jhbuild: 




the most of it." 

Mr Wickham's society was of materiaf service in dispeliing the gloom 
which tlie late perverse occurrences had thrown on many of the Longbourn 
family. They saw him often, and to his other recommendations wras now 
added tliat of general unreserve. The whole of what Elizabeth had already 
heard, his claims on Mr. Darcy, and all that he had suffered from him, 
was now openly acknowledged and publicly canvassed; and everybody was 
pleased to know how much they had always disliked Mr Darcy before they 
had known anything of the matter, 

Miss Bennet was the only creature who could suppose there might be 
any extenuating circumstances in the case, unknown to the society 
of Hertfordshirej her mild and steady candour always pleaded for 
allowances, and urged the possibility of mistakes--but by everybody else 
Mr Darcy was condemned as the worst of men. 
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Miremos como funciona: si has prestado atencion en los otros capitulos 
cuando mencionamos el concepto de "degradacion elegante" 
("degrading gracefully" en ingles), al efectuar los "imports", este codigo 
se com porta como se espera: 

_NEW_TOOLBAR_SUPPORT = True 
try: 

from sugar . graphics . toolbarbox import ToolbarBox 

from sugar . graphics . toolbarbox import ToolbarButton 

from sugar . activity .widgets import StopButton 

from toolbar import ViewToolbar 

from mybutton import MyActivityToolbarButton 
except : 

_NEW_TOOLBAR_SUPPORT = False 

from toolbar import ReadToolbar, ViewToolbar 

Aca hemos tratado de importar una serie de cosas que solo estan en las 
versiones de Sugar que soportan las nuevas barras. Si tuvimos exito, 
entonces NEWTOOLBARSUPPORT quedara con valor True 
(Verdadero), pero si alguno de los imports fallo, la variable cambiara al 
valor False (Falso). Observen que un par de imports que siempre seran 
exitosos estan colocados despues de los tres que pueden llegar a fallar. 
Si alguno de los tres primeros falla no queremos que los otros dos 
ocurran. 

El proximo bloque de codigo en el metodo init () no debe ser 

sorprendente: 

if _NEW_TOOLBAR_SUPPORT: 

self . create_new_toolbar( ) 
else : 

self . create_old_toolbar( ) 

Inclui la creacion de barras de herramientas adentro de los propios 
metodos de la barra, para que sea mas claro como se crean los dos tipos 
diferentes de barras. El codigo de la barra del viejo estilo permanece sin 
cambios y este es el codigo de la barra del nuevo tipo: 

def create_new_toolbar(self ) : 
toolbar_box = ToolbarBox() 

activity_button = MyActivityToolbarButton(self ) 
toolbar_box .toolbar . insert(activity_button, 0) 
activity_button . show( ) 

self .edit_toolbar = activity . EditToolbar( ) 
self .edit_toolbar . undo . props .visible = False 
self .edit_toolbar . redo . props .visible = False 
self .edit_toolbar . separator . props .visible = False 
self .edit_toolbar .copy. set_sensitive( False) 
self .edit_toolbar .copy.connect( 'clicked', 

self . edit_toolbar_copy_cb) 
self .edit_toolbar . paste . props .visible = False 



edit_toolbar_button = ToolbarButton( 
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page=self . edit_toolbar, 

icon_name= 'toolbar-edit' ) 
self .edit_toolbar . show( ) 

toolbar_box .toolbar . insert (edit_toolbar_button, -1) 
edit_toolbar_button . show( ) 

self . view_toolbar = ViewToolbar ( ) 

self . view_toolbar . connect ( 'go-fullscreen' , 

self . view_toolbar_go_f ullscreen_cb) 
self . view_toolbar . zoom_in .connect( 'clicked', 

self . zoom_in_cb) 
self . view_toolbar . zoom_out .connect( 'clicked' , 

self . zoom_out_cb) 
self . view_toolbar . show( ) 
view_toolbar_button = ToolbarButton( 

page=self . view_toolbar, 

icon_name= 'toolbar-view' ) 
toolbar_box . toolbar. insert( 

view_toolbar_button, -1) 
view_toolbar_button . show( ) 

self. back = ToolButton( ' go-previous ' ) 

self . back. set_tooltip(_( ' Back ' ) ) 

self . back. props . sensitive = False 

self. back. connect( 'clicked' , self. go_back_cb) 

toolbar_box . toolbar. insert(self. back, -1) 

self. back. show( ) 

self. forward = ToolButton( ' go-next ' ) 
self. for ward. set_tooltip(_( ' Forward ' ) ) 
self .forward . props . sensitive = False 
self. for ward. connect ( ' clicked ' , 

self . go_f orward_cb) 
toolbar_box . toolbar. insert(self. for ward, -1) 
self. for ward.show() 

num_page_item = gtk .ToolItem( ) 
self . num_page_entry = gtk.Entry() 
self. num_page_entry . set_text ( ' ' ) 
self. num_page_entry . set_alignment(l) 
self. num_page_entry . connect( 'insert-text' , 

self . new_num_page_entry_insert_text_cb) 

self. num_page_entry . connect( 'activate' , 

self . new_num_page_entry_activate_cb) 

self. num_page_entry . set_width_chars(4) 
num_page_item. add ( self . num_page_entry) 
self. num_page_entry . show( ) 

toolbar_box .toolbar . insert (num_page_item, -1) 
num_page_item . show( ) 

total_page_item = gtk.ToolItem( ) 
self . total_page_label = gtk.Label() 

label_attributes = pango . AttrList( ) 
label_at tributes .insert (pango. At trSize( 

14000, 0, -1)) 
label_at tributes .insert (pango. At trForeground( 

65535, 65535, 65535, 0, -1)) 
self. total_page_label. set_attributes( 
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label_at tributes) 

self . total_page_label. set_text ( ' / 0') 
total_page_item. add ( self . total_page_label) 
self . total_page_label . show( ) 

toolbar_box .toolbar . insert (total_page_item, -1) 
total_page_item. show( ) 

separator = gtk .SeparatorToolItem( ) 

separator . props . draw = False 

separator. set_expand(True) 

toolbar_box . toolbar. insert(separator, -1) 

separator . show( ) 



def 



stop_button = StopButton(self ) 

stop_button . props . accelerator = ' <Ctrl><Shif t>Q' 
toolbar_box .toolbar . insert (stop_button, -1) 
stop_button . show( ) 

self . set_toolbar_box(toolbar_box) 
toolbar_box . show( ) 

new_num_page_entry_insert_text_cb(self , entry, 

text, length, position): 

if not re.match( ' [0-9] ' , text): 

entry .einit_s to p_by_name( 'insert-text' ) 

return True 
return False 



def new_num_page_entry_activate_cb(self , entry) 

global page 

if entry . props . text : 

new_page = int(entry. props . text) - 1 
else : 

new_page = 

if new_page >= self . total_pages : 

new_page = self . total_pages - 1 

elif new_page < 0: 
new_page = 



self .current_page = new_page 
self . set_current_page(new_page) 
self . show_page(new_page) 
entry . props . text = str(new_page 
self . update_nav_buttons( ) 
page = new_page 
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def update_nav_buttons(self ) : 

current_page = self . current_page 

self . back. props . sensitive = current_page > 

self .forward . props . sensitive = \ 

current_page < self . total_pages - 1 

self . num_page_entry. props . text = str( 

current_page + 1) 
self . total_page_label. props . label = \ 

' / ' + str(self . total_pages) 
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def set_total_pages(self , pages): 
self . total_pages = pages 

def set_current_page(self , page): 
self .current_page = page 
self. update_nav_buttons( ) 

Comparando los dos metodos vemos que gran parte del codigo es el 
mismo. En particular, las barras de herramientass Vista (View) y Editar 
(Edit) son exactamente iguales a las anteriores, pero en vez de 
convertirse en la barra de herramientas activa, se despliegan debajo de 
la del nuevo estilo. Si hubieramos hecho la barra de herramientas 
"Read" de la misma manera, hubieramos implementado las barras 
antiguas y nuevas con muy poco codigo. Sin embargo, la barra "Read" 
contiene los controles de lectura, especificos de la Actividad y deben por 
su importancia estar disponibles en todo momento en la barra principal. 
Por esto es que cada vez que el codigo se refiere a la barra "Read" tiene 
que tener dos formas de accion alternativas: 

if _NEW_TOOLBAR_SUPPORT: 

self . set_total_pages(pagecount + 1) 

self . set_current_page(page) 
else: 

self . read_toolbar . set_total_pages( 
pagecount + 1) 

self . read_toolbar . set_current_page(page) 

Hay otra cosa importante de resaltar sobre la barra principal de 
herramientas. Cuando se tiene una barra del viejo tipo, el boton de 
Detener (StopButton) queda por defecto en la Barra de Actividad, pero 
si tenemos soporte para barras nuevas, debemos agregar este boton a la 
barra principal. 

separator = gtk. SeparatorToolItem( ) 
separator . props . draw = False 
separator. set_expand(True) 
toolbar_box . toolbar. insert(separator, -1) 
separator . show( ) 

stop_button = StopButton(self ) 

stop_button . props . accelerator = ' <Ctrl><Shif t>Q' 
toolbar_box .toolbar . insert (stop_button, -1) 
stop_button . show( ) 

Observen que deben poner en gtk.SeparatorToolltem el valor True 
para set_expand() antes de poner el StopButton. Con esto se consigue 
que el boton se forme en el extremo derecho de la barra que es donde 
debe estar. 

Solo nos queda discutir la Barra de Actividad: 

toolbar_box = ToolbarBox() 



activity_button = MyActivityToolbarButton(self ) 
toolbar_box .toolbar . insert (activity_but ton, 0) 
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activity_button . show( ) 

En condiciones normales usariamos la clase ActivityToolbarButton 
para crear la Barra de Actividad que se desplega por defecto. El 
problema es que en este caso no tengo manera de ocultar los botones 
Keep (Guardar) y Share (Compartir). Esta version de la Actividad utiliza 
el control de Compartir pero no tiene uso para el boton Guardar. 

El boton Keep ha generado intensas polemicas en las listas de correo. 
Nuevos usuarios de computadoras no saben para que usarlo y usuarios 
experientes pretenden que sea identico a un Save Game (Guardar 
Juego) a la opcion Save As (Guardar Como) en un menu habitual. Keep 
no es una cosa ni otra y puede llevar a confusiones. Por estas razones 
decidi que ninguna de mis actividades tengan este boton visible. Para 
esconder el boton copie un tramo del codigo original de la 
ActivityToolbarButton en un archivo llamado mybutton.py: 



import gtk 
import gconf 

from sugar . graphics . toolbarbox import ToolbarButton 

from sugar . activity .widgets import ActivityToolbar 

from sugar . graphics .xocolor import XoColor 

from sugar . graphics . icon import Icon 

from sugar . bundle. activitybundle import ActivityBundle 

def _create_activity_icon(metadata) : 
if metadata.get( ' icon-color ' , ''): 

color = XoColor(metadata[ ' icon-color '] ) 
else : 

client = gconf . client_get_default() 
color = XoColor(client . get_string( 
'/desktop/sugar/user/color' )) 

from sugar . activity .activity import get_bundle_path 

bundle = ActivityBundle(get_bundle_path( ) ) 

icon = Icon(file=bundle . get_icon( ) , xo_color=color) 

return icon 

class MyActivityToolbarButton(ToolbarButton) : 

def init (self, activity, **kwargs): 

toolbar = ActivityToolbar(activity, 

orientation_lef t=True) 
toolbar. stop. hide() 
toolbar . keep . hide( ) 

ToolbarButton . init (self, page=toolbar, 

**kwargs) 

icon = _create_activity_icon(activity. metadata) 
self . set_icon_widget (icon) 
icon . show( ) 
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La linea en negrita es la unica diferencia entre el codigo orignal y este. 
Si la barra de herramientas hubiera sido solo la instancia de una 
variable (self.toolbar) podria haber usado la clase original. - 



1. Traducido Ana Cichero, Uruguay- 
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Zi\)» ^Como seguimos ahora? 

Este libro intenta darle al programador principiante la informacion 
necesaria para desarrollar y publicar su propia Actividad Sugar. Ya 
contiene varies enlaces a sitios web conteniendo informacion sobre los 
temas que el libro no cubre. En este capitulo todavia agregaremos mas 
recursos que pensamos seran utiles a cualquier desarrollador Sugar. 

Libro de Peter Gill sobre PyGTK 

Mucho del trabajo para desarrollar tus Actividades involucra PyGTK. 
Peter Gill trabaja en un libro que cubre el tema en gran detalle. Este 
libro esta descargable desde aca: 

http://www.majorsilence.com/PyGTK_Book 

Manual de bolsillo de OLPC Austria. 

Este libro es el primer intento de crear un manual que sirva para crear 
Actividades Sugar. Esta dirigido a programadores con experiencia y 
cubre temas en los que no hemos entrado, como por ejempio escribir 
Actividades en lenguajes distintos de Python. El libro fue escrito en 2008 
y aunque tiene cosas caducas es una excelente fuente de informacion. 
Los autores son Christoph Derndorfer y Daniel Jahre. 

http://wiki.sugarlabs.Org/images/5/51/Activity_Handbook_200805_online.pdf 

http://www.olpcaustria.org 

El Almanaque de Sugar 

Esta es una serie de articulos Wiki que cubren las API (Interfaz de 
Programacion de Aplicaciones) de Sugar. Es una fuente muy buena de 
informacion actualizada a la que personalmente acudo de forma 
frecuente. 

http://wiki.sugarlabs.org/go/Development_Team/Almanac 
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Listas de Correo de Sugar Labs 



Sugar Labs tiene varias listas de correo a las que vale la pena 
suscribirse. Personalmente sigo lAEP (It's An Education Project) y la 

lista Sugar-Devel. Sugar-Devel es un buen lugar para preguntar sobre 
el desarrollo de Actividades Sugar y para aprender acerca de los ultimos 
trabajos hechos sobre Sugar mismo. lAEP es un buen lugar para 
obtener ideas que tipo de Actividades quieren maestros y estudiantes asi 
como para obtener feedback /retroalimentacion) sobre tus propias 
Actividades. Cualquiera puede suscribirse desde este link. 

http://lists.sugarlabs.org/ 

PyDoc 

PyDoc es un visor de documentacion generada desde las librerias 
Python en tu computadora, incluyendo las librerias de Sugar. Para 
ejecutarlo debes correr este comando desde una terminal: 

pydoc -p 1234 

Este comando no va a terminar de ejecutarse. Levanta una especie de 
servidor web en tu sistema usando como numero de puerto 1234. 
Puedes acceder a este sitio desde http://localhost:1234. No hay nada 
magico respecto del numero 1234, se puede usar cualquier otro numero 
en su lugar. 

Este sitio te deja seguir links a la documentacion en todas las librerias 
Python que tengas instaladas. Cuando termines de revisar la 
documentacion, puedes parar el comando pydoc regresando a la 
terminal y apretar Ctrl-C (mantener Ctrl apretado y entonces apretar 
tecia "c"). 
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^ J. • Acerca de los autores 



James Simmons 

James Simmons programo profesionalmente desde 1978. En ese 
entonces los programas de computadora se creaban perforando 
agujeros en tarjetas, el medio de almacenamiento mas frecuente eran 
los rollos de cinta, y los discos duros eran tan caros y exoticos, que un 
disco que hoy se llenaria con una linda foto de Jessica Alba se 
consideraba suficiente para respaldar completamente el inventario 
completo de una empresa Fortune 500. - 

La industria ha recorrido un extenso camino desde entonces y tambien 
lo ha hecho James, en su medida. 

James aprendio a programar en el Colegio Comunitario Oakton en 
Morton Grove Illinois y luego en la Universidad de Western Illinois en 
Macomb Illinois. En aquellos tiempos, la mejor oportunidad de empleo 
para un joven era convertirse en contable o en programador de 
computadoras. Mientras estaba en el Colegio James vio un corto de 
Monty Python sobre un contable que deseaba ser domador de leones. 
Esto convencio a James que debia convertirse en programador. 

Los estudios de James en la universidad tuvieron un comienzo duro 
porque se apunto, como primer materia de computacion, en "Lenguaje 
Ensamblador Basico", pensando que basico implicaba que era un 
lenguaje para principiantes. El lenguaje era basico desde el punto de 
vista de la maquina, pero no lo era para los estudiantes. James apenas 
salvo el curso con "D" (calificacion minima) pero en el proceso descubrio 
que realmente disfrutaba programar computadoras y decidio continuar 
sus estudios en computacion y obtuvo su grado de bachiller en Ciencias 
de la Informacion. 

James nacio en 1956, el aho anterior al lanzamiento del Sputnik. Era lo 
que hoy llamamos un nerd. Sus pasatiempos eran los mecanos, los 
juegos de quimica, los microscopios, los kits para diseccion, el 
aeromodelismo, modelos de autos y cohetes, equipos de 
radioaficionados, tratar de hacer cine y escribir historias de ciencia 
ficcion. No tuvo mayor exito en ninguna de estas actividades. 

James participo en la primer promocion GlGl (Give One Get One) del 
proyecto OLPC (One Laptop Per Child) y comenzo a desarrollar 
Actividades para la plataforma Sugar inmediatamente despues. Es autor 
de las Actividades Read Etexts, View Slides, Sugar Commander y Get 
Internet Archive Books. - 
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Oceana Rain Fields 

Oceana Rain Fields - Oceana Rain Fields es artista visual y un espiritu 
creative con gusto por lo inesperado y el deseo de apoyar causas justas y 
nobles con su arte. Se graduo en 2010 del liceo Pacific High School 
ganando varias becas notables. En el mismo aho su pintura "Malaria" 
resulto primera en la competencia de arte "Vision 2010" en el Coos Art 
Museum en Coos Bay, Oregon. Oceana planea continuar su educacion en 
el Southwestern Oregon Community College. 

Oceana es responsable del diseho de la tapa de la version impresa de 
este libro. Como parte del Rural Design Collective, tambien creo la tapa 
e ilustraciones interiores de otro manual FLOSS: "An E-Boolc 
Revolution: Reading and Leading with One Laptop Per Child" 

El equipo de traduccion al espafiol 

En Marzo del 2011, Ana Cichero inicia voluntariamente la traduccion al 
espahol. Es docente de matematica en Uruguay donde Sugar se did a 
conocer a traves de Plan Ceibal. Al llegar el mes de Abril le falta la mitad 
del trabajo y quiere darse por vencida. En Mayo, organizado por 
ceibaljam.org, se realiza un encuentro de desarrolladores Sugar en 
Montevideo (Edujam) y entonces -gracias a la iniciativa de Sebastian 
Silva, Vladimir Castro, Rafael Ortiz y Gonzalo Odiard, desarrolladores 
Sugar que Megan de Peru, Bolivia, Colombia y Argentina 
respectivamente-, se decide formar un equipo para terminar 
colectivamente el trabajo. El equipo myosa-es trabaja sobre Booki 
Flossmanuals. A los nombrados se agregan otros tres habituales de las 
comunidades de desarrollo locales Fernando Cormenzana, Alan Aguiar y 
Juan Michelini. Por ultimo Mega el aporte fundamental de Olga Mattos, 
que ademas de editar cuidadosamente el libro entero, trajo, desde el 
voluntariado de IBM que Integra, a Santiago Zito que se agrega al equipo 
traductor. Todos estos, sumados a Edward Cherlin, que apoya la 
iniciativa desde el vamos y el mismo James Simmons comparten unas 4 
semanas de trabajo e innumerables correos hasta lograr publicar el libro 
en espahol en Junio del 2011 bajo el nombre de CHUAS o Como Hacer 
Una Actividad Sugar. 
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NT: Jessica Alba es una actriz adolescente estadounidense y Fortune 
500 el indice anual de las 500 empresas mas grandes del mundo 
segun la revista estadounidense Fortune- 
NT Give One Get One se traduce como Entrega Una Recibe Una y 
refiere al primer programa de donaciones donde OLPC vendia a 
traves de Amazon las laptops XO solo de a dos, una para el 
comprador y otra para algun nino del mundo. Las Actividades 
realizadas por Simmons son descargables desde 
http://activities.sugarlabs.org— 
Traducido Ana Cichero, Uruguay— 
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22. 



Licencia 



Todos los capitulos son propiedad literaria (copyright) de los autores (ver 
debajo). Salvo que se indique lo contrario, todos los capitulos en este 
manual tienen la licencia GNU General Public License version 2 . El 

texto de la licencia se incluye debajo seguida de una traduccion no oficial 
de la misma. 

Esta documentacion es documentacion libre, usted puede distribuiria y/o 
modificaria bajo los terminos de la licencia publica GNU General Public 
License tal como fue publicada por la fundacion de software libre Free 
Software Foundation, tanto para la version 2 de la licencia 6 (a su 
opcion) cualquier version posterior. 

Esta documentacion se distribuye con la esperanza de que sea util, pero 
SIN NINGUNA GARANTIa, sin siquiera la garantia implicita de 
COMERCIALIZACION o ADECUACION A UN PROPOSITO PARTICULAR. Ver la 
licencia publica GNU General Public License por mayores detalles. 

Usted debe haber recibido junto con esta documentacion una copia de la 
licencia publica GNU General Public License, si no, escriba a la fundacion 
Free Software Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, 
MA 02110-1301, USA. 

Reconocimientos 

Nuchas personas contribuyeron a este libro ademas de los autores 
listados. Ellos ofrecieron asesoramiento, soporte tecnico, correcciones y 
mucho codigo. Si intentara listar todos sus nombres puedo olvidar a 
alguien, por lo tanto dejenme solo agradecer a todos los miembros de la 
lista de distribucion de Sugar-Devel. 

La cubierta de la version impresa Copyright (C) 2010 por Oceana Rain 
Fields. 

La traduccion al espahol tiene por autor al equipo myosa-es en 
m an uales(g)cei baljam.org 

Autores 
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Q FLOSS 

Free manuals for free software - Manuales libres para software libre. 

Licencia publica general 

Version 2, junio 1991 

Copyright (C) 1989, 1991 Free Software Foundation, Inc. 
51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA 
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Todo el mundo tiene permitido copiar y distribuir copias identicas de 
este documento de licencia, pero no esta permitido cambiarlo. 

General Public License 

Version 2, June 1991 

Copyright (C) 1989, 1991 Free Software Foundation, Inc. 
51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA 

Everyone is permitted to copy and distribute verbatim copies 
of this license document, but changing it is not allowed. 

Preamble 

The licenses for most software are designed to take away your freedom 
to share and change it. By contrast, the GNU General Public License is 
intended to guarantee your freedom to share and change free software-- 
to make sure the software is free for all its users. This General Public 
License applies to most of the Free Software Foundation's software and 
to any other program whose authors commit to using it. (Some other 
Free Software Foundation software is covered by the GNU Lesser 
General Public License instead.) You can apply it to your programs, too. 

When we speak of free software, we are referring to freedom, not price. 
Our General Public Licenses are designed to make sure that you have 
the freedom to distribute copies of free software (and charge for this 
service if you wish), that you receive source code or can get it if you 
want it, that you can change the software or use pieces of it in new free 
programs; and that you know you can do these things. 

To protect your rights, we need to make restrictions that forbid anyone 
to deny you these rights or to ask you to surrender the rights. These 
restrictions translate to certain responsibilities for you if you distribute 
copies of the software, or if you modify it. 

For example, if you distribute copies of such a program, whether gratis 
or for a fee, you must give the recipients all the rights that you have. 
You must make sure that they, too, receive or can get the source code. 
And you must show them these terms so they know their rights. 

We protect your rights with two steps: (1) copyright the software, and (2) 
offer you this license which gives you legal permission to copy, distribute 
and/or modify the software. 
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Also, for each author's protection and ours, we want to make certain 
that everyone understands that there is no warranty for this free 
software. If the software is modified by someone else and passed on, we 
want its recipients to know that what they have is not the original, so 
that any problems introduced by others will not reflect on the original 
authors' reputations. 

Finally, any free program is threatened constantly by software patents. 
We wish to avoid the danger that redistributors of a free program will 
individually obtain patent licenses, in effect making the program 
proprietary. To prevent this, we have made it clear that any patent must 
be licensed for everyone's free use or not licensed at all. 

The precise terms and conditions for copying, distribution and 
modification follow. 

TERMS AND CONDITIONS FOR COPYING, DISTRIBUTION AND 
MODIFICATION 

0. This License applies to any program or other work which contains a 
notice placed by the copyright holder saying it may be distributed under 
the terms of this General Public License. The "Program", below, refers to 
any such program or work, and a "work based on the Program" means 
either the Program or any derivative work under copyright law: that is to 
say, a work containing the Program or a portion of it, either verbatim or 
with modifications and/or translated into another language. 
(Hereinafter, translation is included without limitation in the term 
"modification".) Each licensee is addressed as "you". 

Activities other than copying, distribution and modification are not 
covered by this License; they are outside its scope. The act of running 
the Program is not restricted, and the output from the Program is 
covered only if its contents constitute a work based on the Program 
(independent of having been made by running the Program). Whether 
that is true depends on what the Program does. 

1. You may copy and distribute verbatim copies of the Program's source 
code as you receive it, in any medium, provided that you conspicuously 
and appropriately publish on each copy an appropriate copyright notice 
and disclaimer of warranty; keep intact all the notices that refer to this 
License and to the absence of any warranty; and give any other 
recipients of the Program a copy of this License along with the Program. 

You may charge a fee for the physical act of transferring a copy, and you 
may at your option offer warranty protection in exchange for a fee. 

2. You may modify your copy or copies of the Program or any portion of 
it, thus forming a work based on the Program, and copy and distribute 
such modifications or work under the terms of Section 1 above, provided 
that you also meet all of these conditions: 
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a) You must cause the modified files to carry prominent notices 
stating that you changed the files and the date of any change. 

b) You must cause any work that you distribute or publish, that in 
whole or in part contains or is derived from the Program or any part 
thereof, to be licensed as a whole at no charge to all third parties 
under the terms of this License. 

c) If the modified program normally reads commands interactively 
when run, you must cause it, when started running for such 
interactive use in the most ordinary way, to print or display an 
announcement including an appropriate copyright notice and a 
notice that there is no warranty (or else, saying that you provide a 
warranty) and that users may redistribute the program under these 
conditions, and telling the user how to view a copy of this License. 
(Exception: if the Program itself is interactive but does not normally 
print such an announcement, your work based on the Program is not 
required to print an announcement.) 

These requirements apply to the modified work as a whole. If identifiable 
sections of that work are not derived from the Program, and can be 
reasonably considered independent and separate works in themselves, 
then this License, and its terms, do not apply to those sections when you 
distribute them as separate works. But when you distribute the same 
sections as part of a whole which is a work based on the Program, the 
distribution of the whole must be on the terms of this License, whose 
permissions for other licensees extend to the entire whole, and thus to 
each and every part regardless of who wrote it. 

Thus, it is not the intent of this section to claim rights or contest your 
rights to work written entirely by you; rather, the intent is to exercise 
the right to control the distribution of derivative or collective works 
based on the Program. 

In addition, mere aggregation of another work not based on the Program 
with the Program (or with a work based on the Program) on a volume of 
a storage or distribution medium does not bring the other work under 
the scope of this License. 

3. You may copy and distribute the Program (or a work based on it, 
under Section 2) in object code or executable form under the terms of 
Sections 1 and 2 above provided that you also do one of the following: 



a) Accompany it with the complete corresponding machine-readable 
source code, which must be distributed under the terms of Sections 
1 and 2 above on a medium customarily used for software 
interchange; or, 
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b) Accompany it with a written offer, valid for at least three years, to 
give any third party, for a charge no more than your cost of 
physically performing source distribution, a complete machine- 
readable copy of the corresponding source code, to be distributed 
under the terms of Sections 1 and 2 above on a medium customarily 
used for software interchange; or, 

c) Accompany it with the information you received as to the offer to 
distribute corresponding source code. (This alternative is allowed 
only for noncommercial distribution and only if you received the 
program in object code or executable form with such an offer, in 
accord with Subsection b above.) 

The source code for a work means the preferred form of the work for 
making modifications to it. For an executable work, complete source 
code means all the source code for all modules it contains, plus any 
associated interface definition files, plus the scripts used to control 
compilation and installation of the executable. However, as a special 
exception, the source code distributed need not include anything that is 
normally distributed (in either source or binary form) with the major 
components (compiler, kernel, and so on) of the operating system on 
which the executable runs, unless that component itself accompanies 
the executable. 

If distribution of executable or object code is made by offering access to 
copy from a designated place, then offering equivalent access to copy 
the source code from the same place counts as distribution of the source 
code, even though third parties are not compelled to copy the source 
along with the object code. 

4. You may not copy, modify, sublicense, or distribute the Program 
except as expressly provided under this License. Any attempt otherwise 
to copy, modify, sublicense or distribute the Program is void, and will 
automatically terminate your rights under this License. However, parties 
who have received copies, or rights, from you under this License will not 
have their licenses terminated so long as such parties remain in full 
compliance. 

5. You are not required to accept this License, since you have not signed 
it. However, nothing else grants you permission to modify or distribute 
the Program or its derivative works. These actions are prohibited by law 
if you do not accept this License. Therefore, by modifying or distributing 
the Program (or any work based on the Program), you indicate your 
acceptance of this License to do so, and all its terms and conditions for 
copying, distributing or modifying the Program or works based on it. 
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6. Each time you redistribute the Program (or any worl< based on the 
Program), the recipient automatically receives a license from the 
original licensor to copy, distribute or modify the Program subject to 
these terms and conditions. You may not impose any further restrictions 
on the recipients' exercise of the rights granted herein. You are not 
responsible for enforcing compliance by third parties to this License. 

7. If, as a consequence of a court judgment or allegation of patent 
infringement or for any other reason (not limited to patent issues), 
conditions are imposed on you (whether by court order, agreement or 
otherwise) that contradict the conditions of this License, they do not 
excuse you from the conditions of this License. If you cannot distribute 
so as to satisfy simultaneously your obligations under this License and 
any other pertinent obligations, then as a consequence you may not 
distribute the Program at all. For example, if a patent license would not 
permit royalty-free redistribution of the Program by all those who 
receive copies directly or indirectly through you, then the only way you 
could satisfy both it and this License would be to refrain entirely from 
distribution of the Program. 

If any portion of this section is held invalid or unenforceable under any 
particular circumstance, the balance of the section is intended to apply 
and the section as a whole is intended to apply in other circumstances. 

It is not the purpose of this section to induce you to infringe any patents 
or other property right claims or to contest validity of any such claims; 
this section has the sole purpose of protecting the integrity of the free 
software distribution system, which is implemented by public license 
practices. Many people have made generous contributions to the wide 
range of software distributed through that system in reliance on 
consistent application of that system; it is up to the author/donor to 
decide if he or she is willing to distribute software through any other 
system and a licensee cannot impose that choice. 

This section is intended to make thoroughly clear what is believed to be 
a consequence of the rest of this License. 

8. If the distribution and/or use of the Program is restricted in certain 
countries either by patents or by copyrighted interfaces, the original 
copyright holder who places the Program under this License may add an 
explicit geographical distribution limitation excluding those countries, so 
that distribution is permitted only in or among countries not thus 
excluded. In such case, this License incorporates the limitation as if 
written in the body of this License. 

9. The Free Software Foundation may publish revised and/or new 
versions of the General Public License from time to time. Such new 
versions will be similar in spirit to the present version, but may differ in 
detail to address new problems or concerns. 
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Each version is given a distinguishing version number. If the Program 
specifies a version number of this License which applies to it and "any 
later version", you have the option of following the terms and conditions 
either of that version or of any later version published by the Free 
Software Foundation. If the Program does not specify a version number 
of this License, you may choose any version ever published by the Free 
Software Foundation. 

10. If you wish to incorporate parts of the Program into other free 
programs whose distribution conditions are different, write to the author 
to ask for permission. For software which is copyrighted by the Free 
Software Foundation, write to the Free Software Foundation; we 
sometimes make exceptions for this. Our decision will be guided by the 
two goals of preserving the free status of all derivatives of our free 
software and of promoting the sharing and reuse of software generally. 

NO WARRANTY 

11. BECAUSE THE PROGRAM IS LICENSED FREE OF CHARGE, THERE IS NO 
WARRANTY FOR THE PROGRAM, TO THE EXTENT PERMITTED BY 
APPLICABLE LAW. EXCEPT WHEN OTHERWISE STATED IN WRITING THE 
COPYRIGHT HOLDERS AND/OR OTHER PARTIES PROVIDE THE PROGRAM 
"AS IS" WITHOUT WARRANTY OF ANY KIND, EITHER EXPRESSED OR 
IMPLIED, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF 
MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE. THE 
ENTIRE RISK AS TO THE OUALITY AND PERFORMANCE OF THE PROGRAM IS 
WITH YOU. SHOULD THE PROGRAM PROVE DEFECTIVE, YOU ASSUME THE 
COST OF ALL NECESSARY SERVICING, REPAIR OR CORRECTION. 

12. IN NO EVENT UNLESS REOUIRED BY APPLICABLE LAW OR AGREED TO 
IN WRITING WILL ANY COPYRIGHT HOLDER, OR ANY OTHER PARTY WHO 
MAY MODIFY AND/OR REDISTRIBUTE THE PROGRAM AS PERMITTED 
ABOVE, BE LIABLE TO YOU FOR DAMAGES, INCLUDING ANY GENERAL, 
SPECIAL, INCIDENTAL OR CONSEOUENTIAL DAMAGES ARISING OUT OF 
THE USE OR INABILITY TO USE THE PROGRAM (INCLUDING BUT NOT 
LIMITED TO LOSS OF DATA OR DATA BEING RENDERED INACCURATE OR 
LOSSES SUSTAINED BY YOU OR THIRD PARTIES OR A FAILURE OF THE 
PROGRAM TO OPERATE WITH ANY OTHER PROGRAMS), EVEN IF SUCH 
HOLDER OR OTHER PARTY HAS BEEN ADVISED OF THE POSSIBILITY OF 
SUCH DAMAGES. 

END OF TERMS AND CONDITIONS 
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Licencia Publica GNU 



Version 2, Junio de 1991. 

Traduccion no oficial de la abogada mexicana Palmira Granados . 

NOTA IMPORTANTE: Esta es una traduccion no oficial al espahol 
de la GNU General Public License. No ha sido publicada por la Free 
Software Foundation, y no establece legalmente las condiciones de 
distribucion para el software que usa la GNU GPL. Estas 
condiciones se establecen solamente por el texto original, en 
ingles, de la GNU GPL. Sin embargo, esperamos que esta 
traduccion ayude a los hispanoparlantes a entender mejor la GNU 
GPL. 

Preambulo 

Las licencias de la mayoria de los programas de computo estan 
disenadas para coartar la libertad de compartirlos y cambiarlos. Por el 
contrario, la Licencia Publica General GNU pretende garantizar esa 
libertad de compartir y cambiar Software Libre a fin de asegurar que el 
software sea libre para todos sus usuarios. Esta Licencia Publica General 
se aplica a la mayor parte del software de la Free Software Foundation y 
a cualquier otro programa cuyos autores se comprometan a usarla. 
(Algunos otros paquetes de software de la Free Software Foundation 
estan protegidos bajo la Licencia Publica General de Libreria GNU.) Esta 
ultima licencia tambien puede aplicarse a nuevos paquetes de software. 

Cuando se hable de Software Libre, se hace referenda a libertad, no a 
precio. Las Licencias Publicas Generales GNU estan disenadas para 
asegurar que el usuario tenga libertad de distribuir copias de Software 
Libre (y de recibir una remuneracion por este servicio, si asi se desea), 
que ese mismo usuario reciba el codigo fuente o que tenga la posibilidad 
de recibirlo, si asi lo desea, que pueda cambiar o modificar el software o 
utilice solo partes del mismo en nuevos paquetes de Software Libre; y 
que dicho usuario tenga pleno conocimiento de estas facultades. 

Con la finalidad de proteger los derechos antes mencionados, es 
necesario establecer restricciones que prohiban a cualquiera negar esos 
derechos o pedir la renuncia a los mismos. Estas restricciones se 
traducen en ciertas responsabilidades para el usuario que distribuye o 
modifica copias de software protegido bajo estas licencias. 
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Por ejempio, si una persona distribuye copias de un paquete de Software 
Libre protegido bajo esta licencia, ya sea de manera gratuita o a cambio 
de una contraprestacion, esa persona debe dar a los receptores de esa 
distribucion todos y cada uno de los derechos que el o ella misma tenga. 
Asimismo, esa persona debe asegurarse que dichos receptores reciban o 
tengan la posibilidad de recibir el codigo fuente. De igual manera, debe 
mostrarles esta licencia a fin de que tengan conocimiento de los 
derechos de los que son titulares. 

La proteccion que otorga la presente licencia se hace de dos maneras 
simultaneas: (1) se otorga proteccion al software bajo la ley de 
copyright, y (2) se ofrece la proteccion bajo esta licencia, la cual otorga 
permiso legal para copiar, distribuir y/o modificar el software. 

Asimismo, a fin de proteger a cada uno de los autores y a los creadores 
mismos de esta licencia, es importante hacer notar y que todos 
entiendan que no existe ninguna garantia de cualquier paquete de 
Software Libre por la cual se deba responder. Esto es, si el software es 
modificado por alguna persona distinta del autor y distribuido con esas 
modificaciones, los receptores de esa distribucion deben saber que lo 
que han recibido no es la obra original, y que por lo tanto, cualquier 
problema surgido de las modificaciones no se reflejara en la reputacion 
del autor original. 

Finalmente, cualquier programa de Software Libre es amenazado por 
patentes de Software. Esta licencia tiene la finalidad de evitar el peligro 
que representa que los redistribuidores de programas de Software Libre 
obtengan individualmente licencias de patentes, haciendo de esta 
forma, programas de Software Propietario. Para lograr esto, queda 
totalmente claro que cualquier patente debe otorgar licencias que 
permitan el uso libre del programa para todos o no otorgar licencia 
alguna. 

Los terminos y condiciones especificos para copiar, distribuir o modificar 
son los siguientes: 

TERMINOS Y CONDICIONES PARA LA COPIA, DISTRIBUCION Y 
MODIFICACION 
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O.Esta licencia se aplica a cualquier programa u otra obra que contenga 
un aviso puesto por el titular de los derechos de autor en el que se 
establezca que el mismo puede ser distribuido bajo los terminos de esta 
Licencia Publica General. El "Programa" se refiere a cualquier programa 
u obra, y "Obra basada en el Programa" se refiere por su parte, a, ya sea 
al "Programa" mismo a cualquier obra derivada del mismo segun la ley 
de Derechos de Autor; esto es, una obra que contenga el "Programa" o 
una porcion del mismo, ya sea que esta porcion sea exactamente igual o 
modificada y/o traducida a otro idioma. (En adelante, una traduccion se 
considerara de manera enunciativa, mas no limitativa, como una 
"modificacion".) 

Actividades distintas de copiar o distribuir no son abarcadas por esta 
licencia; estan fuera de su alcance. El acto de correr el "Programa" no 
esta restringido, y el producto que resulte del "Programa" esta protegido 
solo si su contenido constituye una "obra basada en el Programa" 
(independientemente de haber sido creado por el "Programa" que 
corre.) El que esto ocurra de esa manera depende de lo que el 
"Programa" haga. 

l.Esta permitido copiar y distribuir por cualquier medio copias fieles del 
codigo fuente del "Programa" tal y como fue recibido, siempre y cuando 
se publique en cada copia, de manera conspicua y apropiada, el aviso 
apropiado de derechos de autor y la renuncia a responder por la 
garantia correspondiente al "Programa", se mantengan intactos los 
avisos referentes a esta licencia y a la respectiva ausencia de cualquier 
garantia; y se entregue a los receptores del "Programa" una copia de 
esta licencia. 

Exigir una remuneracion por el acto fisico de transferir una copia esta 
permitido; asimismo, tambien esta permitido ofrecer una garantia a 
cambio de una contraprestacion. 

2. Esta permitido modificar la copia o copias del "Programa" o cualquier 
parte del mismo, creando de esta forma, una "Obra basada en el 
Programa." Asimismo, esta permitido copiar y distribuir las 
modificaciones antes mencionadas o la obra misma bajo los terminos de 
la Seccion 1 mencionada anteriormente, y siempre y cuando se cumplan 
de igual manera las condiciones siguientes: 

■a)Colocaci6n de avisos, en la obra misma y por parte de quien realiza 
las modificaciones, en los que se informe que los archivos fueron 
modificados y la fecha de esas modificaciones. 

■b) Otorgamiento de una licencia bajo los terminos establecidos en esta 
Licencia Publica General que abarque la obra en su totalidad y sin cargo 
a terceras personas para el caso en el que se distribuya o publique una 
obra que contenga todo o parte del "Programa" o que constituya una 
obra derivada del mismo. 
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■c)Si el programa modificado normalmente lee comandos de manera 
interactiva cuando corre, cuando empiece a correr con dicho proposito 
interactivo, es necesario que aparezca un aviso que incluya la leyenda 
de derechos de autor correspondiente, asi como la ausencia de 
responsabilidad por la garantia. Asimismo, dicho aviso debera establecer 
que los usuarios de dicho programa tienen autorizacion para 
redistribuirlo bajo las mismas condiciones en las que les fue distribuido y 
les debera informar como podran tener acceso a una copia de esta 
licencia. (La excepcion a esta condicion tiene lugar cuando se trata de 
una "Obra basada en un Programa" que es en si mismo interactivo, pero 
no envia normalmente un aviso.) 

Las condiciones antes mencionadas se aplican a las obras modificadas 
como un todo. En el caso en el que las secciones de dicha obra que no se 
deriven del "Programa" sean identificables y razonablemente 
independientes y puedan separarse entre ellas, esta licencia y sus 
terminos no se aplicaran a dichas secciones cuando estas sean 
distribuidas como obras separadas. Sin embargo, cuando esas mismas 
secciones se distribuyan como parte de la "Obra basada en el 
Programa", dicha distribucion debera hacerse de acuerdo a los terminos 
de esta licencia, cuyas autorizaciones para otros licenciatarios tendran 
los mismos alcances, sin importar que parte creo quien. 

Por medio de esta seccion no se pretende exigir derechos o impugnar los 
derechos originados de una obra creada en su totalidad por otra 
persona, sino mas bien se tiene como finalidad ejercer el derecho de 
controlar la distribucion de obras derivadas o colectivas basadas en el 
"Programa". 

Asimismo, la sola inclusion de otra obra que no se base en el 
"Programa" aunada al "Programa" (o a una "Obra basada en el 
Programa") dentro de un medio de almacenamiento o distribucion no 
provoca que dicha obra deba regirse por esta licencia. 

3.Copiar y distribuir el "Programa" (o una "Obra basada en el Programa" 
de acuerdo a la seccion 2), bajo los terminos de las secciones 1 y 2 
mencionadas anteriormente, ya sea en codigo objeto o en su forma 
ejecutable esta permitido, siempre y cuando dicho "Programa" se 
acompahe tambien por cualquiera de los siguientes: 

■a)EI codigo fuente respectivo completo y leible por una maquina, el cual 
debe ser distribuido bajo los terminos establecidos en las secciones 1 y 2 
mencionadas anteriormente y a traves de un medio normalmente usado 
para el intercambio de software; 
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■b)Una oferta por escrito y con una validez minima de tres anos, de 
proporcionar a cualquier tercera persona, por una cuota que no exceda 
el costo del acto fisico de distribuir, bajo los terminos de las secciones 1 
y 2 antes mencionadas; y a traves de un medio normalmente usado para 
el intercambio de software; una copia del respectivo codigo fuente 
completo y leible por una maquina; o, 

■c)Toda la informacion recibida respecto a la oferta de distribucion del 
codigo fuente correspondiente. (Esta alternativa esta permitida 
unicamente para distribuciones no comerciales y siempre y cuando el 
"Programa" se haya recibido en codigo objeto o en forma ejecutable 
junto con esta oferta de acuerdo a la subseccion b antes mencionada.) 

El codigo fuente de una obra se refiere a la forma preferida para hacerle 
modificaciones. En una obra ejecutable, el codigo fuente completo se 
refiere a todo el codigo fuente de todos los modulos que contiene, 
ademas de cualquier archivo de definicion de interfaz asociado y de los 
scripts utilizados para controlar la compilacion e instalacion del 
ejecutable. Sin embargo, como una excepcion especial, el codigo fuente 
distribuido no debe incluir cualquier cosa que sea normalmente 
distribuida (ya sea en forma de binarios o de codigo fuente) con los 
principales componentes del sistema operativo (como compilador, 
kernel, etc.) sobre el cual el ejecutable corre, a menos que el mismo 
componente acompane al ejecutable. 

Si la distribucion del ejecutable o del codigo objeto se Neva a cabo 
mediante el ofrecimiento de acceso a una copia en un lugar designado, 
el ofrecimiento de acceso al codigo fuente en el mismo lugar equivale a 
la distribucion de dicho codigo fuente, aun cuando terceras personas no 
esten obligadas a copiar el codigo fuente junto con el codigo objeto. 

4. El "Programa" no puede copiarse, modificarse, sublicenciarse ni 
distribuirse a menos que se haga bajo los terminos y condiciones de esta 
licencia. Cualquier intento por hacer lo anterior de otra forma, sera nulo 
y extinguira automaticamente los derechos surgidos de esta licencia. Sin 
embargo, las licencias de las personas que hayan recibido copias o 
derechos bajo esta licencia, seguiran vigentes mientras dichas personas 
cumplan con sus obligaciones. 

5. Mientras no se firme la presente licencia no existe obligacion de 
aceptarla. Sin embargo, no existe autorizacion, y por lo tanto esta 
legalmente prohibido, modificar o distribuir el "Programa" o una "Obra 
basada en el Programa" a menos que se acepten los terminos y 
condiciones de la presente licencia. Por lo anterior, del acto de modificar 
distribuir el "Programa" o una "Obra basada en el Programa" se 
presume la aceptacion de los terminos y condiciones de la presente 
licencia para copiar, distribuir o modificar dicho "Programa" u "Obra 
basada en el Programa". 
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e.Cada vez que se distribuya el "Programa" (o cualquier "Obra basada 
en el Programa"), quien recibe la copia del mismo recibe tambien, de 
manera automatica una licencia de parte del licenciante original para 
copiar, distribuir o modificar el "Programa" bajo los terminos y 
condiciones de esta licencia. No podran imponerse mas restricciones al 
ejercicio de los derechos del licenciatario que los establecidos en esta 
licencia. Quien distribuye el "Programa" no es responsable por el 
cumplimiento de la presente licencia por parte de terceras personas. 

7. En el caso en el que como consecuencia de orden judicial o de las 
pretensiones demandadas por violacion a una patente o por cualquier 
otra razon (de manera enunciativa, mas no limitativa) se imponen 
condiciones (ya sea por orden judicial, contrato o por otro medio) que se 
contradicen con las condiciones de esta licencia, estas ultimas no se 
eximen de su cumplimiento. Como consecuencia de la imposibilidad de 
cumplir con ambas obligaciones mencionadas, el "Programa" no podra 
distribuirse. Por ejempio, si una licencia de una patente prohibe la 
redistribucion gratuita del "Programa" por parte de quienes reciben 
copias del mismo de manera directa o indirecta, entonces la unica forma 
de cumplir con ambas licencias, esta y la de la patente, sera abstenerse 
de distribuir el "Programa". 

En el caso en el que cualquier parte de esta seccion sea declarada 
invalida o inexigible bajo cualquier circunstancia particular, el resto de la 
misma continuara surtiendo sus efectos para esa circunstancia, al igual 
que la seccion en su totalidad para las demas circunstancias. 

El proposito de esta seccion no es inducir a la violacion de patentes o del 
ejercicio de otros derechos intelectuales, como tampoco impugnar la 
validez de tales demandas por incumplimiento, sino mas bien, pretende 
proteger la integridad del sistema de distribucion del Software Libre, el 
cual consiste en la practica y uso de licencias publicas. Mucha gente ha 
hecho generosas contribuciones a paquetes de software distribuidos bajo 
este sistema confiando en la aplicacion de dicho sistema; y es decision 
del autor/donante distribuir el software a traves de cualquier otro 
sistema sin que un licenciatario pueda interferir en esa decision. 

Esta seccion pretende aclarar todo aquello que se considera 
consecuencia del resto de esta licencia. 

8. En el caso en el que la distribucion y/o uso del "Programa este 
restringida en ciertos paises, ya sea por patentes o interfases protegidas 
por el sistema de propiedad intelectual, el titular original de los 
derechos de autor del "Programa" que lo sujeta a esta licencia tiene la 
facultad de agregar una limitacion de tipo geografico a la distribucion, 
por virtud de la cual se excluya a dichos paises; de manera que la 
distribucion del mismo se permita unicamente en los paises no 
excluidos. En este caso, dicha limitacion se tiene como parte integrante 
de esta licencia. 
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9.Es facultad de la Free Software Foundation publicar, en cualquier 
momento, tanto versiones revisadas como versiones de reciente 
creacion, de la Licencia Publica General. Las versiones nuevas pueden 
diferir en detalles a fin de afrontar y resolver nuevos problemas o 
preocupaciones, pero conservando siempre el espiritu de la presente 
version. 

Cada version tendra asignado un numero. En el caso en el que el 
"Programa" especifique un numero de version de esta licencia para su 
aplicacion y ademas, incluya la frase "y cualquier version posterior", el 
licenciatario podra sujetarse, a su eleccion, a los terminos y condiciones 
de la version expresamente mencionada o de cualquiera de las 
versiones posteriores de la misma publicadas por la Free Software 
Foundation. Por otro lado, en el caso en el que el "programa" no 
especifique un numero de version de licencia, el licenciatario podra 
elegir cualquier version que haya sido publicada por la Free Software 
Foundation. 

10. En el caso en el que se deseen incorporar partes del "Programa" a 
otros paquetes de Software Libre cuyas condiciones de distribucion 
difieran a estas, es necesario solicitar permiso por escrito al autor. 
Cuando se trate de software cuyo titular de los de los derechos de autor 
correspondientes sea la Free Software Foundation, la solicitud de 
permiso debera dirigirse a esta ultima, quien en algunas ocasiones hace 
excepciones como esta. La decision emitida por la Free Software 
Foundation se basara tomando en cuenta la finalidad de preservar el 
estatus libre de todos los derivados del Software Libre y de promocionar 
que se comparta y se reutilice el software en general. 

EXCLUSION DE GARANTIA 

ll.COMO CONSECUENCIA DE QUE EL "PROGRAMA" SE LICENCIE COMO 
GRATUITO, EN LA MEDIDA EN OUE LA LEY APLICABLE LO PERMITA, NO 
EXISTIRA GARANTIA ALGUNA por la OUE SE DEBA RESPONDER. SALVO 
DISPOSICION ESCRITA EN CONTRARIO, LOS TITU LARES DE LOS DERECHOS 
DE AUTOR RESPECTIVOS Y/U OTRAS PARTES PONEN A DISPOSICION EL 
"PROGRAMA" SIN GARANTIA DE NINGUN TlPO, EXPRESA O IMPLICITA, 
INCLUYENDO DE MANERA ENUNCIATIVA MAS NO LIMITATIVA, LAS 
GARANTiAS IMPLICITAS DE TlPO COMERCIAL U OTRAS INHERENTES A 
ALGUN PROPOSITO ESPECIFICO. EL RIESGO DE OUE EL "PROGRAMA" ESTE 
EN PERFECTAS CONDICIONES Y FUNCIONE TAL Y COMO DEBE FUNCIONAR 
CORRE POR CUENTA DE OUIEN LO RECIBE, AL IGUAL OUE LOS GASTOS 
NECESARIOS PARA SU SERVICIO, REPARACION O CORRECCION EN EL DADO 
CASO EN EL OUE DICHO "PROGRAMA" CONTENGA DEFECTOS. 
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12.A MENOS QUE ASI LO DISPONGA LA LEY APLICABLE O EXISTA ACUERDO 
ESCRITO EN CONTRARIO, NINGUN TITULAR DE LOS DERECHOS DE AUTOR 
O PERSONA FACULTADA, SEGUN LAS SECCIONES ANTERIORES DE LA 
PRESENTE, PARA MODIFICAR Y/0 DISTRIBUIR EL "PROGRAMA" SERA 
RESPONSABLE POR LOS DANOS YA SEAN GENERALES, ESPECIALES, 
INCIDENTALES O CONSECUENCIALES RESULTADO DEL USO O 
INCAPACIDAD DE USO DEL "PROGRAMA" (INCLUYENDO DE MANERA 
ENUNCIATIVA MAS NO LIMITATIVA LA PERDIDA DE INFORMACION, 
INEXACTITUD EN LA INFORMACION, PERDIDAS SUFRIDAS POR EL USUARIO 
DEL "PROGRAMA" O POR TERCERAS PERSONAS O LA INCAPACIDAD DEL 
"PROGRAMA" PARA OPERAR CON OTROS PROGRAMAS), AUN CUANDO 
DICHO TITULAR O CUALOUIER OTRA PERSONA HAYA ADVERTIDO DICHA 
POSIBILIDAD DE DANO. 



FIN DE LOS TERMINOS Y CONDICIONES 
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